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

更多...

命名空间

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 系统要求。