System.Configuration.ConfigurationProperty 类
方法描述
表示配置元素的一个特性或子级。 此类不能被继承。
语法定义(C# System.Configuration.ConfigurationProperty 类 的用法)
public sealed class ConfigurationProperty
构造函数
| 构造函数名称 | 构造函数描述 |
|---|---|
| ConfigurationProperty(String, Type) | 初始化 ConfigurationProperty 类的新实例。 |
| ConfigurationProperty(String, Type, Object) | 初始化 ConfigurationProperty 类的新实例。 |
| ConfigurationProperty(String, Type, Object, ConfigurationPropertyOptions) | 初始化 ConfigurationProperty 类的新实例。 |
| ConfigurationProperty(String, Type, Object, TypeConverter, ConfigurationValidatorBase, ConfigurationPropertyOptions) | 初始化 ConfigurationProperty 类的新实例。 |
| ConfigurationProperty(String, Type, Object, TypeConverter, ConfigurationValidatorBase, ConfigurationPropertyOptions, String) | 初始化 ConfigurationProperty 类的新实例。 |
成员/方法
| 方法名称 | 方法描述 |
|---|---|
| Equals(Object) | 确定指定的 Object 是否等于当前的 Object。 （继承自 Object。） |
| Finalize | 允许对象在“垃圾回收”回收之前尝试释放资源并执行其他清理操作。 （继承自 Object。） |
| GetHashCode | 用作特定类型的哈希函数。 （继承自 Object。） |
| GetType | 获取当前实例的 Type。 （继承自 Object。） |
| MemberwiseClone | 创建当前 Object 的浅表副本。 （继承自 Object。） |
| ToString | 返回表示当前对象的字符串。 （继承自 Object。） |
提示和注释
在简单的 ConfigurationElement（例如下一示例中所示的 CustomSection）中，ConfigurationProperty 对象表示 fileName 一类的特性。
在较为复杂的配置元素（例如包含子节的节，像 authentication）中，ConfigurationProperty 对象既可以表示 ConfigurationElement 对象，也可以表示特性。
ConfigurationPropertyCollection 类表示 ConfigurationProperty 对象的集合，这些对象可以是特性，也可以是配置元素的 ConfigurationElement 对象。
ConfigurationProperty 类表示单个配置设置。 此类允许您获取或设置特定配置实体（特性或元素）的名称、类型和默认值，并指定该特性是否为必需特性、是否为元素的键，或是否表示默认的元素集合。
对实现者的说明
每个 ConfigurationElement 对象都为表示其元素特性或子元素集合的 ConfigurationProperty 对象创建一个内部的 ConfigurationPropertyCollection 集合。
无法自定义的信息和功能都包含在 ElementInformation 属性所提供的 ElementInformation 对象中。
可使用编程或声明性（特性化）编码模型创建自定义配置元素。
编程模型。 此模型需要为每个元素特性创建一个属性来获取和/或设置其值，并将该值添加到基础 ConfigurationElement 基类的内部属性包中。
声明性模型。 这一较为简单的模型也称为特性化模型，允许您通过使用某个属性，并用特性修饰该属性的方式来定义元素特性。 这些特性将属性类型及其默认值通知给 ASP.NET 配置系统。 利用通过反射获取的此信息，ASP.NET 配置系统将创建元素属性对象，并执行所需的初始化。
System.Configuration.ConfigurationProperty 类例子
下面的示例演示如何在代码中创建以上部分。
// Define a custom section programmatically.
static void CreateSection()
{
try
{
CustomSection customSection;
// Get the current configuration file.
System.Configuration.Configuration config =
ConfigurationManager.OpenExeConfiguration(
ConfigurationUserLevel.None);
// Create the section entry
// in the and the
// related target section in .
// Call it "CustomSection2" since the file in this
// example already has "CustomSection".
if (config.Sections["CustomSection"] == null)
{
customSection = new CustomSection();
config.Sections.Add("CustomSection2", customSection);
customSection.SectionInformation.ForceSave = true;
config.Save(ConfigurationSaveMode.Full);
}
}
catch (ConfigurationErrorsException err)
{
Console.WriteLine(err.ToString());
}
}
线程安全
此类型的任何公共 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 系统要求。