ConfigurationElementCollection.CreateNewElement(String) Método

Definição

Namespace:

Microsoft.Web.Administration

Assembly:

Microsoft.Web.Administration.dll

Cria um novo elemento para a coleção atual.

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

Parâmetros

elementTagName

String

O nome do elemento a ser criado.

Retornos

ConfigurationElement

Uma referência ao novo ConfigurationElement objeto que foi criado.

Exemplos

O exemplo a seguir demonstra o CreateNewElement método. Este exemplo define vários valores de atributo e adiciona o elemento recém-criado à coleção de elementos. Este exemplo de código faz parte de um exemplo maior fornecido para a 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)";

Comentários

Substitua o CreateNewElement método para criar objetos personalizados ConfigurationElement de um tipo específico. Quando uma coleção é carregada do arquivo de configuração, CreateNewElement é chamada para criar elementos individuais. CreateNewElement deve ser substituído em classes derivadas da ConfigurationElementCollection classe .

Depois que um elemento é criado, os atributos do elemento devem ser definidos e o elemento deve ser adicionado à coleção de elementos.

Quando um elemento de configuração é adicionado ao ConfigurationElementCollection objeto e atualizado com o Update método , ele é armazenado no arquivo Administration.config.

Quando o elemento de configuração é criado, ele deve ser criado com um atributo de nome exclusivo. Se o atributo name não for exclusivo, ocorrerá um erro.