ConfigurationElementCollection.BaseAdd Methode

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Fügt einer ConfigurationElement-Instanz beim Überschreiben in einer abgeleiteten Klasse ein ConfigurationElementCollection hinzu.

Überlädt

BaseAdd(ConfigurationElement)	Fügt der ConfigurationElementCollection ein Konfigurationselement hinzu.
BaseAdd(ConfigurationElement, Boolean)	Fügt der Konfigurationselementauflistung ein Konfigurationselement hinzu.
BaseAdd(Int32, ConfigurationElement)	Fügt der Konfigurationselementauflistung ein Konfigurationselement hinzu.

Hinweise

Verwenden Sie die BaseAdd -Methode, um der Auflistung ein neues ConfigurationElement hinzuzufügen. Überschreiben Sie in einer abgeleiteten Klasse, wenn beim Hinzufügen des Elements benutzerdefiniertes Verhalten erforderlich ist.

Beim Hinzufügen wird ein Element nur dann als Duplikat betrachtet, wenn die Schlüssel identisch sind, die Werte sich aber unterscheiden. Elemente mit gleichen Schlüsseln und Werten werden ohne Meldung akzeptiert, da die Elemente nicht in Konflikt miteinander stehen. Allerdings kann ein Element mit identischem Schlüssel, aber abweichendem Wert, nicht hinzugefügt werden, da keine Logik vorhanden ist, anhand derer bestimmt werden könnte, welcher der beiden in Konflikt stehenden Werte berücksichtigt werden soll.

BaseAdd(ConfigurationElement)

Quelle:

ConfigurationElementCollection.cs

Fügt der ConfigurationElementCollection ein Konfigurationselement hinzu.

C#

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

Parameter

element

ConfigurationElement

Das hinzuzufügende ConfigurationElement.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie die BaseAdd -Methode überschrieben und von einer Add -Methode aufgerufen wird.

C#

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

    // Your custom code goes here.
}

Hinweise

Verwenden Sie die BaseAdd -Methode, um der Auflistung ein neues ConfigurationElement hinzuzufügen. Überschreiben Sie es in einer abgeleiteten Klasse, wenn beim Hinzufügen des Elements benutzerdefiniertes Verhalten erforderlich ist.

Beim Hinzufügen wird ein Element nur dann als Duplikat betrachtet, wenn die Schlüssel identisch sind, die Werte sich aber unterscheiden. Elemente mit gleichen Schlüsseln und Werten werden ohne Meldung akzeptiert, da die Elemente nicht in Konflikt miteinander stehen. Allerdings kann ein Element mit identischem Schlüssel, aber abweichendem Wert, nicht hinzugefügt werden, da keine Logik vorhanden ist, anhand derer bestimmt werden könnte, welcher der beiden in Konflikt stehenden Werte berücksichtigt werden soll.

BaseAdd(ConfigurationElement, Boolean)

Quelle:

ConfigurationElementCollection.cs

Fügt der Konfigurationselementauflistung ein Konfigurationselement hinzu.

C#

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

Parameter

element

ConfigurationElement

Das hinzuzufügende ConfigurationElement.

throwIfExists

Boolean

true, um eine Ausnahme auszulösen, wenn das angegebene ConfigurationElement bereits in der ConfigurationElementCollection enthalten ist; andernfalls false.

Ausnahmen

Exception

Das hinzuzufügende ConfigurationElement ist bereits in der ConfigurationElementCollection vorhanden, und der throwIfExists-Parameter ist true.

Hinweise

Verwenden Sie den optionalen Parameter throwIfExists , um eine Exception Ausnahme auszulösen, wenn das angegebene ConfigurationElement Objekt bereits in der ConfigurationElementCollection Auflistung vorhanden ist.

Ein Element gilt nur dann als Duplikat, wenn die Schlüssel identisch sind, sich die Werte aber unterscheiden. Elemente mit gleichen Schlüsseln und Werten werden ohne Meldung akzeptiert, da die Elemente nicht in Konflikt miteinander stehen. Allerdings kann ein Element mit identischem Schlüssel, aber abweichendem Wert, nicht hinzugefügt werden, da keine Logik vorhanden ist, anhand derer bestimmt werden könnte, welcher der beiden in Konflikt stehenden Werte berücksichtigt werden soll.

BaseAdd(Int32, ConfigurationElement)

Quelle:

ConfigurationElementCollection.cs

Fügt der Konfigurationselementauflistung ein Konfigurationselement hinzu.

C#

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

Parameter

index

Int32

Die Indexposition, an der das angegebene ConfigurationElement hinzugefügt werden soll.

element

ConfigurationElement

Das hinzuzufügende ConfigurationElement.

Hinweise

Verwenden Sie den index -Parameter, um das ConfigurationElement -Objekt an einem bestimmten Indexspeicherort hinzuzufügen ConfigurationElementCollection .