ConfigurationElementCollection.BaseAdd 方法

定义

命名空间:

System.Configuration

程序集:

System.Configuration.ConfigurationManager.dll

包:

System.Configuration.ConfigurationManager v8.0.0

在派生的类中重写时，向 ConfigurationElement 实例添加 ConfigurationElementCollection。

重载

BaseAdd(ConfigurationElement)	向 ConfigurationElementCollection 添加配置元素。
BaseAdd(ConfigurationElement, Boolean)	向配置元素集合添加配置元素。
BaseAdd(Int32, ConfigurationElement)	向配置元素集合添加配置元素。

注解

BaseAdd使用 方法将新的 ConfigurationElement 添加到集合。 如果在添加 元素时需要自定义行为，则重写派生类。

添加元素时，只有键相同而值不同的元素才被视为重复元素。 键和值都相同的元素将被接受并且不给出提示，原因是这些元素不会相互竞争。 但是，无法添加键相同而值不同的元素，因为无法从逻辑上确定哪个竞争值有效。

BaseAdd(ConfigurationElement)

Source:

ConfigurationElementCollection.cs

向 ConfigurationElementCollection 添加配置元素。

protected:
 virtual void BaseAdd(System::Configuration::ConfigurationElement ^ element);

protected virtual void BaseAdd (System.Configuration.ConfigurationElement element);

abstract member BaseAdd : System.Configuration.ConfigurationElement -> unit
override this.BaseAdd : System.Configuration.ConfigurationElement -> unit

Protected Overridable Sub BaseAdd (element As ConfigurationElement)

参数

element

ConfigurationElement

要添加的 ConfigurationElement。

示例

下面的代码示例演示如何重写 BaseAdd 方法以及如何从方法 Add 调用它。

public void Add(UrlConfigElement url)
{
    BaseAdd(url);

    // Your custom code goes here.
}

Public Sub Add(ByVal url As UrlConfigElement)
    BaseAdd(url)

    ' Your custom code goes here.

End Sub

注解

BaseAdd使用 方法将新的 ConfigurationElement 添加到集合。 如果在添加 元素时需要自定义行为，则重写派生类中的它。

添加元素时，只有键相同而值不同的元素才被视为重复元素。 键和值都相同的元素将被接受并且不给出提示，原因是这些元素不会相互竞争。 但是，无法添加键相同而值不同的元素，因为无法从逻辑上确定哪个竞争值有效。

BaseAdd(ConfigurationElement, Boolean)

Source:

ConfigurationElementCollection.cs

向配置元素集合添加配置元素。

protected public:
 void BaseAdd(System::Configuration::ConfigurationElement ^ element, bool throwIfExists);

protected internal void BaseAdd (System.Configuration.ConfigurationElement element, bool throwIfExists);

member this.BaseAdd : System.Configuration.ConfigurationElement * bool -> unit

Protected Friend Sub BaseAdd (element As ConfigurationElement, throwIfExists As Boolean)

参数

element

ConfigurationElement

要添加的 ConfigurationElement。

throwIfExists

Boolean

true 表示如果指定的 ConfigurationElement 已包含在 ConfigurationElementCollection 中则引发异常；否则为 false。

例外

Exception

要添加的 ConfigurationElement 已存在于 ConfigurationElementCollection 中，并且 throwIfExists 参数为 true。

注解

如果集合中ConfigurationElementCollection已存在指定的ConfigurationElement对象，请使用可选参数throwIfExists引发Exception异常。

仅当键相同但值不同时，元素才被视为重复元素。 键和值都相同的元素将被接受并且不给出提示，原因是这些元素不会相互竞争。 但是，无法添加键相同而值不同的元素，因为无法从逻辑上确定哪个竞争值有效。

BaseAdd(Int32, ConfigurationElement)

Source:

ConfigurationElementCollection.cs

向配置元素集合添加配置元素。

protected:
 virtual void BaseAdd(int index, System::Configuration::ConfigurationElement ^ element);

protected virtual void BaseAdd (int index, System.Configuration.ConfigurationElement element);

abstract member BaseAdd : int * System.Configuration.ConfigurationElement -> unit
override this.BaseAdd : int * System.Configuration.ConfigurationElement -> unit

Protected Overridable Sub BaseAdd (index As Integer, element As ConfigurationElement)

参数

index

Int32

要添加指定 ConfigurationElement 的索引位置。

element

ConfigurationElement

要添加的 ConfigurationElement。

注解

index使用 参数将 ConfigurationElement 对象添加到ConfigurationElementCollection位于特定索引位置的 。