ConfigurationElementCollection.CreateNewElement(String) メソッド

定義

名前空間:

Microsoft.Web.Administration

アセンブリ:

Microsoft.Web.Administration.dll

現在のコレクションの新しい要素を作成します。

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

パラメーター

elementTagName

String

作成する要素の名前。

戻り値

ConfigurationElement

作成された新しい ConfigurationElement オブジェクトへの参照。

例

CreateNewElementメソッドの例を次に示します。 次の使用例は、いくつかの属性値を設定し、新しく作成した要素を要素コレクションに追加します。 このコード例は、ConfigurationElement クラスのために提供されている大規模な例の一部です。

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

注釈

メソッドを CreateNewElement オーバーライドして、特定の型のカスタム ConfigurationElement オブジェクトを作成します。 構成ファイルからコレクションが読み込まれると、 が呼び出され、 CreateNewElement 個々の要素が作成されます。 CreateNewElement は、 クラスから派生したクラスでオーバーライドする ConfigurationElementCollection 必要があります。

要素が作成されたら、要素の属性を設定し、要素を要素コレクションに追加する必要があります。

構成要素が オブジェクトに追加され、 ConfigurationElementCollection メソッドで Update 更新されると、Administration.config ファイルに格納されます。

構成要素を作成するときは、一意の name 属性を使用して作成する必要があります。 name 属性が一意でない場合は、エラーが発生します。