ConfigurationElementCollection.BaseAdd Méthode

Définition

Espace de noms:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paquet:

System.Configuration.ConfigurationManager v8.0.0

Ajoute un ConfigurationElement à une instance de ConfigurationElementCollection en cas de substitution dans une classe dérivée.

Surcharges

BaseAdd(ConfigurationElement)	Ajoute un élément de configuration à ConfigurationElementCollection.
BaseAdd(ConfigurationElement, Boolean)	Ajoute un élément de configuration à la collection d'éléments de configuration.
BaseAdd(Int32, ConfigurationElement)	Ajoute un élément de configuration à la collection d'éléments de configuration.

Remarques

Utilisez la BaseAdd méthode pour ajouter un nouveau ConfigurationElement à la collection. Remplacez dans une classe dérivée si un comportement personnalisé est requis lorsque l’élément est ajouté.

Lors d'un ajout, un élément est considéré comme un doublon uniquement si les clés sont identiques mais que les valeurs sont différentes. Les éléments dont les clés et les valeurs sont identiques sont acceptés en mode silencieux car ils ne se concurrencent pas. Toutefois, un élément ayant une clé identique mais une valeur différente ne peut pas être ajouté car aucune logique ne permet de déterminer les valeurs en concurrence qui doivent être honorées.

BaseAdd(ConfigurationElement)

Source:

ConfigurationElementCollection.cs

Ajoute un élément de configuration à 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)

Paramètres

element

ConfigurationElement

ConfigurationElement à ajouter.

Exemples

L’exemple de code suivant montre comment remplacer la BaseAdd méthode et comment l’appeler à partir d’une Add méthode.

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

Remarques

Utilisez la BaseAdd méthode pour ajouter un nouveau ConfigurationElement à la collection. Remplacez-le dans une classe dérivée si un comportement personnalisé est requis lorsque l’élément est ajouté.

Lors d'un ajout, un élément est considéré comme un doublon uniquement si les clés sont identiques mais que les valeurs sont différentes. Les éléments dont les clés et les valeurs sont identiques sont acceptés en mode silencieux car ils ne se concurrencent pas. Toutefois, un élément ayant une clé identique mais une valeur différente ne peut pas être ajouté car aucune logique ne permet de déterminer les valeurs en concurrence qui doivent être honorées.

BaseAdd(ConfigurationElement, Boolean)

Source:

ConfigurationElementCollection.cs

Ajoute un élément de configuration à la collection d'éléments de configuration.

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)

Paramètres

element

ConfigurationElement

ConfigurationElement à ajouter.

throwIfExists

Boolean

true pour lever une exception si le ConfigurationElement spécifié est déjà contenu dans ConfigurationElementCollection ; sinon, false.

Exceptions

Exception

Le ConfigurationElement à ajouter existe déjà dans ConfigurationElementCollection et le paramètre throwIfExists est true.

Remarques

Utilisez le paramètre throwIfExists facultatif pour lever une Exception exception si l’objet spécifié ConfigurationElement existe déjà dans la ConfigurationElementCollection collection.

Un élément est considéré comme un doublon uniquement si les clés sont identiques, mais les valeurs sont différentes. Les éléments dont les clés et les valeurs sont identiques sont acceptés en mode silencieux car ils ne se concurrencent pas. Toutefois, un élément ayant une clé identique mais une valeur différente ne peut pas être ajouté car aucune logique ne permet de déterminer les valeurs en concurrence qui doivent être honorées.

BaseAdd(Int32, ConfigurationElement)

Source:

ConfigurationElementCollection.cs

Ajoute un élément de configuration à la collection d'éléments de configuration.

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)

Paramètres

index

Int32

Emplacement d'index où ajouter le ConfigurationElement spécifié.

element

ConfigurationElement

ConfigurationElement à ajouter.

Remarques

Utilisez le index paramètre pour ajouter l’objet ConfigurationElement au à un ConfigurationElementCollection emplacement d’index spécifique.