System.Configuration.SchemeSettingElementCollection 类

上一篇：System.Configuration.SchemeSettingElement 类下一篇：System.Configuration.SchemeSettingElementCollection.IndexOf 方法

方法描述

表示 SchemeSettingElement 对象的集合。

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

[ConfigurationCollectionAttribute(typeof(SchemeSettingElementCollection), CollectionType = ConfigurationElementCollectionType.AddRemoveClearMap, 
	AddItemName = "add", ClearItemsName = "clear", RemoveItemName = "remove")]
public sealed class SchemeSettingElementCollection : ConfigurationElementCollection

构造函数

构造函数名称	构造函数描述
SchemeSettingElementCollection	初始化 SchemeSettingElementCollection 类的新实例。

成员/方法

方法名称	方法描述
BaseAdd(ConfigurationElement)	向 ConfigurationElementCollection 添加配置元素。（继承自 ConfigurationElementCollection。）
BaseAdd(ConfigurationElement, Boolean)	向配置元素集合添加配置元素。（继承自 ConfigurationElementCollection。）
BaseAdd(Int32, ConfigurationElement)	向配置元素集合添加配置元素。（继承自 ConfigurationElementCollection。）
BaseClear	从集合中移除所有配置元素对象。（继承自 ConfigurationElementCollection。）
BaseGet(Int32)	获取位于指定索引位置的配置元素。（继承自 ConfigurationElementCollection。）
BaseGet(Object)	返回具有指定键的配置元素。（继承自 ConfigurationElementCollection。）
BaseGetAllKeys	返回 ConfigurationElementCollection 中包含的所有配置元素的键数组。（继承自 ConfigurationElementCollection。）
BaseGetKey	获取位于指定索引位置的 ConfigurationElement 的键。（继承自 ConfigurationElementCollection。）
BaseIndexOf	指定 ConfigurationElement 的索引。（继承自 ConfigurationElementCollection。）
BaseIsRemoved	获取一个值，该值指示是否已从 ConfigurationElementCollection 中移除具有指定键的 ConfigurationElement。（继承自 ConfigurationElementCollection。）
BaseRemove	从集合中移除 ConfigurationElement。（继承自 ConfigurationElementCollection。）
BaseRemoveAt	移除位于指定索引位置的 ConfigurationElement。（继承自 ConfigurationElementCollection。）
CopyTo	将 ConfigurationElementCollection 的内容复制到数组。（继承自 ConfigurationElementCollection。）
CreateNewElement()	当在派生的类中重写时，创建一个新的 ConfigurationElement。（继承自 ConfigurationElementCollection。）
CreateNewElement(String)	在派生的类中重写时，创建新的 ConfigurationElement。（继承自 ConfigurationElementCollection。）
DeserializeElement	读取配置文件中的 XML。（继承自 ConfigurationElement。）
Equals	将 ConfigurationElementCollection 与指定的对象进行比较。（继承自 ConfigurationElementCollection。）
Finalize	允许对象在“垃圾回收”回收之前尝试释放资源并执行其他清理操作。（继承自 Object。）
GetElementKey	在派生类中重写时获取指定配置元素的元素键。（继承自 ConfigurationElementCollection。）
GetEnumerator	基础结构。获取用于循环访问 ConfigurationElementCollection 的 IEnumerator。（继承自 ConfigurationElementCollection。）
GetHashCode	获取表示 ConfigurationElementCollection 实例的唯一值。（继承自 ConfigurationElementCollection。）
GetTransformedAssemblyString	返回指定程序集名称的转换版本。（继承自 ConfigurationElement。）
GetTransformedTypeString	返回指定类型名称的转换版本。（继承自 ConfigurationElement。）
GetType	获取当前实例的 Type。（继承自 Object。）
IndexOf	指定的 SchemeSettingElement 的索引。
Init	将 ConfigurationElement 对象设置为其初始状态。（继承自 ConfigurationElement。）
InitializeDefault	用于初始化 ConfigurationElement 对象的默认值集。（继承自 ConfigurationElement。）
IsElementName	指示指定的 ConfigurationElement 是否存在于 ConfigurationElementCollection 中。（继承自 ConfigurationElementCollection。）
IsElementRemovable	获取一个值，该值指示是否可从 ConfigurationElementCollection 中移除指定的 ConfigurationElement。（继承自 ConfigurationElementCollection。）
IsModified	在派生的类中重写时，指示从最后一次保存或加载此 ConfigurationElementCollection 后是否对其进行了修改。（继承自 ConfigurationElementCollection。）
IsReadOnly	获取一个值，该值指示 ConfigurationElementCollection 对象是否为只读。（继承自 ConfigurationElementCollection。）
ListErrors	将此 ConfigurationElement 对象以及所有子元素中无效属性的错误添加到传递的列表中。（继承自 ConfigurationElement。）
MemberwiseClone	创建当前 Object 的浅表副本。（继承自 Object。）
OnDeserializeUnrecognizedAttribute	获取一个值，该值指示反序列化过程中是否遇到未知特性。（继承自 ConfigurationElement。）
OnDeserializeUnrecognizedElement	导致配置系统引发异常。（继承自 ConfigurationElementCollection。）
OnRequiredPropertyNotFound	未找到所需属性时引发异常。（继承自 ConfigurationElement。）
PostDeserialize	反序列化后调用。（继承自 ConfigurationElement。）
PreSerialize	序列化前调用。（继承自 ConfigurationElement。）
Reset	在派生的类中重写时，将 ConfigurationElementCollection 重置为其未被修改时的状态。（继承自 ConfigurationElementCollection。）
ResetModified	在派生的类中重写时，将 IsModified 属性的值重置为 false。（继承自 ConfigurationElementCollection。）
SerializeElement	在派生的类中重写时，将配置数据写入配置文件中的 XML 元素。（继承自 ConfigurationElementCollection。）
SerializeToXmlElement	当在派生类中实现后，将此配置元素的外部标记写入配置文件。（继承自 ConfigurationElement。）
SetPropertyValue	将属性设置为指定值。（继承自 ConfigurationElement。）
SetReadOnly	基础结构。为 ConfigurationElementCollection 对象和所有子元素设置 IsReadOnly 属性。（继承自 ConfigurationElementCollection。）
ToString	返回表示当前对象的字符串。（继承自 Object。）
Unmerge	基础结构。反转将配置层次结构的不同级别配置的信息合并在一起的效果（继承自 ConfigurationElementCollection。）

提示和注释

SchemeSettingElementCollection 类代表在配置文件内 Uri 部分下的元素。

SchemeSettingElementCollection 类和配置文件中的节的外观泛型，表示应用程序可以指定任何方案的任何 System.GenericUriParserOptions 枚举值。事实上，仅支持 HTTP 和 HTTPS 方案的 GenericUriParserOptions.DontUnescapePathDotsAndSlashes 标志。所有其他设置都被忽略。

默认情况下，在执行路径压缩前，System.Uri 类将取消转义百分号编码的路径分隔符。这实现为抵御类似于如下攻击的安全机制：

http://www.contoso.com/.. %2F.. %2F/Windows/System32/cmd.exe?/c+dir+c:\

如果在未正确处理百分号编码的字符的情况下将此 URI 传递给模块，可能会导致服务器执行下面的命令：

c:\Windows\System32\cmd.exe /c dir c:\

因此，System.Uri 类首先取消转义路径分隔符，然后再应用路径压缩。将上面的恶意 URL 传递给 System.Uri 类构造函数将导致产生以下 URI：

http://www.microsoft.com/Windows/System32/cmd.exe?/c+dir+c:\

可以将此默认行为修改为不取消转义 SchemeSettingElement 类的百分号编码的路径分隔符。