System.Configuration.ConfigurationElementCollection 类
方法描述
表示包含一个子元素集合的配置元素。
语法定义(C# System.Configuration.ConfigurationElementCollection 类 的用法)
public abstract class ConfigurationElementCollection : ConfigurationElement, ICollection, IEnumerable
构造函数
构造函数名称 | 构造函数描述 |
---|---|
ConfigurationElementCollection() | 初始化 ConfigurationElementCollection 类的新实例。 |
ConfigurationElementCollection(IComparer) | 创建 ConfigurationElementCollection 类的新实例。 |
成员/方法
方法名称 | 方法描述 |
---|---|
BaseAdd(ConfigurationElement) | 向 ConfigurationElementCollection 添加配置元素。 |
BaseAdd(ConfigurationElement, Boolean) | 向配置元素集合添加配置元素。 |
BaseAdd(Int32, ConfigurationElement) | 向配置元素集合添加配置元素。 |
BaseClear | 从集合中移除所有配置元素对象。 |
BaseGet(Int32) | 获取位于指定索引位置的配置元素。 |
BaseGet(Object) | 返回具有指定键的配置元素。 |
BaseGetAllKeys | 返回 ConfigurationElementCollection 中包含的所有配置元素的键数组。 |
BaseGetKey | 获取位于指定索引位置的 ConfigurationElement 的键。 |
BaseIndexOf | 指定 ConfigurationElement 的索引。 |
BaseIsRemoved | 获取一个值,该值指示是否已从 ConfigurationElementCollection 中移除具有指定键的 ConfigurationElement。 |
BaseRemove | 从集合中移除 ConfigurationElement。 |
BaseRemoveAt | 移除位于指定索引位置的 ConfigurationElement。 |
CopyTo | 将 ConfigurationElementCollection 的内容复制到数组。 |
CreateNewElement() | 当在派生的类中重写时,创建一个新的 ConfigurationElement。 |
CreateNewElement(String) | 在派生的类中重写时,创建新的 ConfigurationElement。 |
DeserializeElement | 读取配置文件中的 XML。 (继承自 ConfigurationElement。) |
Equals | 将 ConfigurationElementCollection 与指定的对象进行比较。 (重写 ConfigurationElement.Equals(Object)。) |
Finalize | 允许对象在“垃圾回收”回收之前尝试释放资源并执行其他清理操作。 (继承自 Object。) |
GetElementKey | 在派生类中重写时获取指定配置元素的元素键。 |
GetEnumerator | 基础结构。获取用于循环访问 ConfigurationElementCollection 的 IEnumerator。 |
GetHashCode | 获取表示 ConfigurationElementCollection 实例的唯一值。 (重写 ConfigurationElement.GetHashCode()。) |
GetTransformedAssemblyString | 返回指定程序集名称的转换版本。 (继承自 ConfigurationElement。) |
GetTransformedTypeString | 返回指定类型名称的转换版本。 (继承自 ConfigurationElement。) |
GetType | 获取当前实例的 Type。 (继承自 Object。) |
Init | 将 ConfigurationElement 对象设置为其初始状态。 (继承自 ConfigurationElement。) |
InitializeDefault | 用于初始化 ConfigurationElement 对象的默认值集。 (继承自 ConfigurationElement。) |
IsElementName | 指示指定的 ConfigurationElement 是否存在于 ConfigurationElementCollection 中。 |
IsElementRemovable | 获取一个值,该值指示是否可从 ConfigurationElementCollection 中移除指定的 ConfigurationElement。 |
IsModified | 在派生的类中重写时,指示从最后一次保存或加载此 ConfigurationElementCollection 后是否对其进行了修改。 (重写 ConfigurationElement.IsModified()。) |
IsReadOnly | 获取一个值,该值指示 ConfigurationElementCollection 对象是否为只读。 (重写 ConfigurationElement.IsReadOnly()。) |
ListErrors | 将此 ConfigurationElement 对象以及所有子元素中无效属性的错误添加到传递的列表中。 (继承自 ConfigurationElement。) |
MemberwiseClone | 创建当前 Object 的浅表副本。 (继承自 Object。) |
OnDeserializeUnrecognizedAttribute | 获取一个值,该值指示反序列化过程中是否遇到未知特性。 (继承自 ConfigurationElement。) |
OnDeserializeUnrecognizedElement | 导致配置系统引发异常。 (重写 ConfigurationElement.OnDeserializeUnrecognizedElement(String, XmlReader)。) |
OnRequiredPropertyNotFound | 未找到所需属性时引发异常。 (继承自 ConfigurationElement。) |
PostDeserialize | 反序列化后调用。 (继承自 ConfigurationElement。) |
PreSerialize | 序列化前调用。 (继承自 ConfigurationElement。) |
Reset | 在派生的类中重写时,将 ConfigurationElementCollection 重置为其未被修改时的状态。 (重写 ConfigurationElement.Reset(ConfigurationElement)。) |
ResetModified | 在派生的类中重写时,将 IsModified 属性的值重置为 false。 (重写 ConfigurationElement.ResetModified()。) |
SerializeElement | 在派生的类中重写时,将配置数据写入配置文件中的 XML 元素。 (重写 ConfigurationElement.SerializeElement(XmlWriter, Boolean)。) |
SerializeToXmlElement | 当在派生类中实现后,将此配置元素的外部标记写入配置文件。 (继承自 ConfigurationElement。) |
SetPropertyValue | 将属性设置为指定值。 (继承自 ConfigurationElement。) |
SetReadOnly | 基础结构。为 ConfigurationElementCollection 对象和所有子元素设置 IsReadOnly 属性。 (重写 ConfigurationElement.SetReadOnly()。) |
ToString | 返回表示当前对象的字符串。 (继承自 Object。) |
Unmerge | 基础结构。反转将配置层次结构的不同级别配置的信息合并在一起的效果 (重写 ConfigurationElement.Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)。) |
提示和注释
ConfigurationElementCollection 表示配置文件中的元素的集合。
注意
配置文件中的元素称为基本 XML 元素或节。 简单元素是具有相关特性(如果有)的 XML 标记。 简单元素组成节。 复杂节可包含一个或多个简单元素、元素集合和其他节。
通过 ConfigurationElementCollection 可使用 ConfigurationElement 对象的集合。 实现此类,以便将自定义 ConfigurationElement 元素的集合添加到 ConfigurationSection 中。
对实现者的说明
可使用编程或声明性(特性化)编码模型创建自定义配置元素。
编程模型要求为每个元素特性创建一个属性以获取和设置其值,并将该属性添加到基础 ConfigurationElement 基类的内部属性包中。
声明性模型(也称特性化模型)允许通过使用属性并为其配置特性来定义元素特性。 这些特性将属性类型及其默认值通知给 ASP.NET 配置系统。 ASP.NET 可使用反射获取此信息,然后创建元素属性对象并执行必需的初始化。
System.Configuration.ConfigurationElementCollection 类例子
当运行控制台应用程序时,将创建 UrlsSection 类实例,并将在应用程序配置文件中生成以下配置元素:
System.Object System.Configuration.ConfigurationElement
System.Configuration.ConfigurationElementCollection
更多...
线程安全
此类型的任何公共 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 系统要求。