ConfigurationElementCollection.BaseAdd Method

Definition

Добавляет ConfigurationElement к экземпляру ConfigurationElementCollection при переопределении в производном классе.Adds a ConfigurationElement to an ConfigurationElementCollection instance when overridden in a derived class.

Overloads

BaseAdd(ConfigurationElement)

Добавляет новый элемент конфигурации в ConfigurationElementCollection.Adds a configuration element to the ConfigurationElementCollection.

BaseAdd(ConfigurationElement, Boolean)

Добавляет элемент конфигурации в коллекцию элементов конфигурации.Adds a configuration element to the configuration element collection.

BaseAdd(Int32, ConfigurationElement)

Добавляет элемент конфигурации в коллекцию элементов конфигурации.Adds a configuration element to the configuration element collection.

Remarks

Для добавления нового ConfigurationElement в коллекцию используется метод BaseAdd.Use the BaseAdd method to add a new ConfigurationElement to the collection. Переопределяйте в производном классе, если при добавлении элемента требуется настраиваемое поведение.Override in a derived class if custom behavior is required when the element is added.

При добавлении элемент считается дубликатом, только если ключи идентичны, но значения различаются.When adding, an element is considered a duplicate only if the keys are identical but the values are different. Элементы с идентичными ключами и значениями принимаются без уведомления, так как они еще не завершены.Elements with identical keys and values are accepted silently because the elements do not compete. Однако нельзя добавить элемент с идентичным ключом, но другим значением, так как отсутствует логика для выбора одного из конкурирующих значений.However, an element with an identical key but a different value cannot be added because there is no logic to determine which of the competing values should be honored.

BaseAdd(ConfigurationElement)

Добавляет новый элемент конфигурации в ConfigurationElementCollection.Adds a configuration element to the 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)

Parameters

element
ConfigurationElement

Добавляемый объект ConfigurationElement.The ConfigurationElement to add.

Examples

В следующем примере кода показано, как переопределить метод BaseAdd и вызвать его из метода Add.The following code example shows how to override the BaseAdd method and how to call it from an Add method.

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

Remarks

Для добавления нового ConfigurationElement в коллекцию используется метод BaseAdd.Use the BaseAdd method to add a new ConfigurationElement to the collection. Переопределяйте его в производном классе, если при добавлении элемента требуется настраиваемое поведение.Override it in a derived class if custom behavior is required when the element is added.

При добавлении элемент считается дубликатом, только если ключи идентичны, но значения различаются.When adding, an element is considered a duplicate only if the keys are identical but the values are different. Элементы с идентичными ключами и значениями принимаются без уведомления, так как они еще не завершены.Elements with identical keys and values are accepted silently because the elements do not compete. Однако нельзя добавить элемент с идентичным ключом, но другим значением, так как отсутствует логика для выбора одного из конкурирующих значений.However, an element with an identical key but a different value cannot be added because there is no logic to determine which of the competing values should be honored.

BaseAdd(ConfigurationElement, Boolean)

Добавляет элемент конфигурации в коллекцию элементов конфигурации.Adds a configuration element to the configuration element collection.

protected:
 void BaseAdd(System::Configuration::ConfigurationElement ^ element, bool throwIfExists);
protected public:
 void BaseAdd(System::Configuration::ConfigurationElement ^ element, bool throwIfExists);
protected 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 Sub BaseAdd (element As ConfigurationElement, throwIfExists As Boolean)
Protected Friend Sub BaseAdd (element As ConfigurationElement, throwIfExists As Boolean)

Parameters

element
ConfigurationElement

Добавляемый объект ConfigurationElement.The ConfigurationElement to add.

throwIfExists
Boolean

Значение true, чтобы выдать исключение, если указанный ConfigurationElement уже содержится в ConfigurationElementCollection; в противном случае — значение false.true to throw an exception if the ConfigurationElement specified is already contained in the ConfigurationElementCollection; otherwise, false.

Exceptions

Добавляемый ConfigurationElement уже существует в ConfigurationElementCollection и параметр throwIfExists равен true.The ConfigurationElement to add already exists in the ConfigurationElementCollection and the throwIfExists parameter is true.

Remarks

Используйте необязательный параметр throwIfExists, чтобы вызвать исключение Exception, если указанный объект ConfigurationElement уже существует в коллекции ConfigurationElementCollection.Use the optional parameter throwIfExists to throw an Exception exception if the specified ConfigurationElement object already exists in the ConfigurationElementCollection collection.

Элемент считается дублирующимся, только если ключи идентичны, но значения различны.An element is considered a duplicate only if the keys are identical but the values are different. Элементы с идентичными ключами и значениями принимаются без уведомления, так как они еще не завершены.Elements with identical keys and values are accepted silently because the elements do not compete. Однако нельзя добавить элемент с идентичным ключом, но другим значением, так как отсутствует логика для выбора одного из конкурирующих значений.However, an element with an identical key but a different value cannot be added because there is no logic to determine which of the competing values should be honored.

BaseAdd(Int32, ConfigurationElement)

Добавляет элемент конфигурации в коллекцию элементов конфигурации.Adds a configuration element to the configuration element collection.

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)

Parameters

index
Int32

Расположение индекса, в которое добавляется указанный ConfigurationElement.The index location at which to add the specified ConfigurationElement.

element
ConfigurationElement

Добавляемый объект ConfigurationElement.The ConfigurationElement to add.

Remarks

Используйте параметр index, чтобы добавить объект ConfigurationElement в ConfigurationElementCollection в определенном расположении индекса.Use the index parameter to add the ConfigurationElement object to the ConfigurationElementCollection at a specific index location.

Applies to