ConfigurationElementCollection.CreateNewElement(String) Methode

Referenz

Definition

Namespace:: Microsoft.Web.Administration

Assembly:: Microsoft.Web.Administration.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Erstellt ein neues Element für die aktuelle Auflistung.

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

Parameter

elementTagName: String

Der Name des zu erstellenden Elements.

Gibt zurück

ConfigurationElement

Ein Verweis auf das neue ConfigurationElement Objekt, das erstellt wurde.

Beispiele

Das folgende Beispiel veranschaulicht die CreateNewElement Methode. In diesem Beispiel werden mehrere Attributwerte festgelegt und das neu erstellte Element der Elementauflistung hinzugefügt. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ConfigurationElement-Klasse bereitgestellt wird.

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

Hinweise

Überschreiben Sie die CreateNewElement -Methode, um benutzerdefinierte ConfigurationElement Objekte eines bestimmten Typs zu erstellen. Wenn eine Auflistung aus der Konfigurationsdatei geladen wird, wird aufgerufen, CreateNewElement um einzelne Elemente zu erstellen. CreateNewElement muss in Klassen überschrieben werden, die von der ConfigurationElementCollection -Klasse abgeleitet werden.

Nachdem ein Element erstellt wurde, müssen die Attribute des Elements festgelegt werden, und das Element muss der Elementauflistung hinzugefügt werden.

Wenn dem -Objekt ein Konfigurationselement hinzugefügt ConfigurationElementCollection und mit der Update -Methode aktualisiert wird, wird es in der Administration.config-Datei gespeichert.

Wenn das Konfigurationselement erstellt wird, muss es mit einem eindeutigen Name-Attribut erstellt werden. Wenn das name-Attribut nicht eindeutig ist, tritt ein Fehler auf.

Gilt für:

Share via