ConfigurationElementCollection.BaseAdd Méthode

Définition

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
Source:
ConfigurationElementCollection.cs
Source:
ConfigurationElementCollection.cs

Ajoute un élément de configuration à ConfigurationElementCollection.

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

Paramètres

Exemples

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

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

    // Your custom code goes here.
}

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.

S’applique à

.NET Framework 4.8.1 et autres versions
Produit Versions
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

BaseAdd(ConfigurationElement, Boolean)

Source:
ConfigurationElementCollection.cs
Source:
ConfigurationElementCollection.cs
Source:
ConfigurationElementCollection.cs

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

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

Paramètres

throwIfExists
Boolean

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

Exceptions

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.

S’applique à

.NET Framework 4.8.1 et autres versions
Produit Versions
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

BaseAdd(Int32, ConfigurationElement)

Source:
ConfigurationElementCollection.cs
Source:
ConfigurationElementCollection.cs
Source:
ConfigurationElementCollection.cs

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

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

Paramètres

index
Int32

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

Remarques

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

S’applique à

.NET Framework 4.8.1 et autres versions
Produit Versions
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9