ConfigurationElementCollection.CreateNewElement(String) Méthode

Définition

Espace de noms:

Microsoft.Web.Administration

Assembly:

Microsoft.Web.Administration.dll

Crée un élément pour la collection actuelle.

protected:
 override Microsoft::Web::Administration::ConfigurationElement ^ CreateNewElement(System::String ^ elementTagName);

protected override Microsoft.Web.Administration.ConfigurationElement CreateNewElement (string elementTagName);

override this.CreateNewElement : string -> Microsoft.Web.Administration.ConfigurationElement

Protected Overrides Function CreateNewElement (elementTagName As String) As ConfigurationElement

Paramètres

elementTagName

String

Nom de l'élément à créer.

Retours

ConfigurationElement

Référence au nouvel ConfigurationElement objet créé.

Exemples

L’exemple suivant illustre la CreateNewElement méthode. Cet exemple montre comment définir plusieurs valeurs d’attribut et ajouter l’élément nouvellement créé à la collection d’éléments. Cet exemple de code fait partie d’un exemple plus grand fourni pour la ConfigurationElement classe .

// Use any of the following lines to set the attribute value.
// attribute.Value = "TestDemo(Modified)";
moduleproviderelement.SetAttributeValue(
    "name", "TestDemo(Modified)");
// moduleproviderelement["name"] = "TestDemo(Modified)";

Remarques

Remplacez la CreateNewElement méthode pour créer des objets personnalisés ConfigurationElement d’un type spécifique. Lorsqu’une collection est chargée à partir du fichier de configuration, CreateNewElement est appelée pour créer des éléments individuels. CreateNewElement doit être substitué dans les classes qui dérivent de la ConfigurationElementCollection classe .

Une fois qu’un élément est créé, les attributs de l’élément doivent être définis et l’élément doit être ajouté à la collection d’éléments.

Lorsqu’un élément de configuration est ajouté à l’objet ConfigurationElementCollection et mis à jour avec la Update méthode , il est stocké dans le fichier Administration.config.

Lorsque l’élément de configuration est créé, il doit être créé avec un attribut de nom unique. Si l’attribut name n’est pas unique, une erreur se produit.