ConfigurationElementCollection.BaseAdd Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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)
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.
S’applique à
BaseAdd(ConfigurationElement, Boolean)
Ajoute un élément de configuration à la collection d'éléments de configuration.
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)
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
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 à
BaseAdd(Int32, ConfigurationElement)
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.