System.Configuration.ConfigurationPropertyAttribute 类

方法描述

以声明方式指示 .NET Framework,以实例化配置属性。 此类不能被继承。

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

[AttributeUsageAttribute(AttributeTargets.Property)]
public sealed class ConfigurationPropertyAttribute : Attribute

构造函数

构造函数名称 构造函数描述
ConfigurationPropertyAttribute 基础结构。初始化 ConfigurationPropertyAttribute 类的新实例。

成员/方法

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

提示和注释

您可以使用 ConfigurationPropertyAttribute 修饰配置属性,此配置属性将会指示 .NET Framework 使用修饰参数的值对该属性进行实例化和初始化。

注意

创建自定义配置元素最简便的方法就是使用特性化(声明性)模型。 您可以声明自定义公共属性,并使用 ConfigurationPropertyAttribute 特性来修饰它们。 对于每一个标记有此特性的属性,.NET Framework 都使用反射来读取修饰参数,并创建相关的 ConfigurationProperty 实例。 也可以使用编程模型,在这种情况下,您将负责声明自定义的公共属性,并返回它们的集合。

.NET Framework 配置系统提供的特性类型可在创建自定义配置元素期间使用。 特性类型有两种:

指示 .NET Framework 如何实例化自定义配置元素属性的类型。 这些类型包括:

ConfigurationCollectionAttribute

ConfigurationPropertyAttribute

指示 .NET Framework 如何验证自定义配置元素属性的类型。 这些类型包括:

IntegerValidatorAttribute

LongValidatorAttribute

RegexStringValidatorAttribute

StringValidatorAttribute

TimeSpanValidatorAttribute

System.Configuration.ConfigurationPropertyAttribute 类例子

以下是部分配置文件,包含在上例中定义的自定义节。



    
        

继承层次结构

System.Object

System.Attribute

System.Configuration.ConfigurationPropertyAttribute

命名空间

namespace: System.Configuration

程序集: System.Configuration(在 System.Configuration.dll 中)

线程安全

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

版本信息

.NET Framework 受以下版本支持:4、3.5、3.0、2.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 系统要求。