System.AttributeUsageAttribute 类

方法描述

指定另一特性类的用法。 此类不能被继承。

语法定义(C# System.AttributeUsageAttribute 类 的用法)

[SerializableAttribute]
[ComVisibleAttribute(true)]
[AttributeUsageAttribute(AttributeTargets.Class, Inherited = true)]
public sealed class AttributeUsageAttribute : Attribute

构造函数

构造函数名称 构造函数描述
AttributeUsageAttribute 用指定的 AttributeTargets、AllowMultiple 值和 Inherited 值列表初始化 AttributeUsageAttribute 类的新实例。

成员/方法

方法名称 方法描述
Equals 基础结构。返回一个值,该值指示此实例是否与指定的对象相等。 (继承自 Attribute。)
Finalize 允许对象在“垃圾回收”回收之前尝试释放资源并执行其他清理操作。 (继承自 Object。)
GetHashCode 返回此实例的哈希代码。 (继承自 Attribute。)
GetType 获取当前实例的 Type。 (继承自 Object。)
IsDefaultAttribute 当在派生类中重写时,指示此实例的值是否是派生类的默认值。 (继承自 Attribute。)
Match 当在派生类中重写时,返回一个指示此实例是否等于指定对象的值。 (继承自 Attribute。)
MemberwiseClone 创建当前 Object 的浅表副本。 (继承自 Object。)
ToString 返回表示当前对象的字符串。 (继承自 Object。)

提示和注释

定义您自己的特性类时,可通过在特性类上放置 AttributeUsageAttribute 来控制特性类的使用方式。 指示的特性类必须直接或间接地从 Attribute 派生。

特性类具有定位参数和命名参数。 特性类的每个公共构造函数为该类定义一个有效的定位参数序列。 命名参数则由特性类的非静态、公共和读写字段或属性定义。

通过定义以下参数设置 AttributeUsageAttribute 的三个属性:

ValidOn

该定位参数指定可在其上放置所指示的特性的程序元素。 AttributeTargets 枚举中列出了可在其上放置特性的所有可能元素的集。 可通过按位“或”运算组合多个 AttributeTargets 值,以获取所需的有效程序元素组合。

AllowMultiple

该命名参数指定能否为给定的程序元素多次指定所指示的特性。

Inherited

该命名参数指定所指示的特性能否由派生类和重写成员继承。

有关使用特性的更多信息,请参见 Attribute 和 利用特性扩展元数据。

System.AttributeUsageAttribute 类例子


继承层次结构

System.Object

System.Attribute

System.AttributeUsageAttribute

命名空间

namespace: System

程序集: mscorlib(在 mscorlib.dll 中)

线程安全

此类型的任何公共 static(在 Visual Basic 中为 Shared) 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

版本信息

.NET Framework 受以下版本支持:4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1 受以下版本支持:

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。