ConfigurationElementCollection.BaseAdd Método

Definição

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacote:

System.Configuration.ConfigurationManager v8.0.0

Adiciona um ConfigurationElement a uma instância ConfigurationElementCollection quando substituído em uma classe derivada.

Sobrecargas

BaseAdd(ConfigurationElement)	Adiciona um elemento de configuração ao ConfigurationElementCollection.
BaseAdd(ConfigurationElement, Boolean)	Adiciona um elemento de configuração à coleção de elementos de configuração.
BaseAdd(Int32, ConfigurationElement)	Adiciona um elemento de configuração à coleção de elementos de configuração.

Comentários

Use o BaseAdd método para adicionar um novo ConfigurationElement à coleção. Substitua em uma classe derivada se o comportamento personalizado for necessário quando o elemento for adicionado.

Ao adicionar, um elemento será considerado duplicado somente se as chaves forem idênticas, mas os valores forem diferentes. Elementos com chaves e valores idênticos são aceitos silenciosamente, porque os elementos não competem. No entanto, um elemento com uma chave idêntica, mas um valor diferente não pode ser adicionado porque não há nenhuma lógica para determinar qual dos valores concorrentes deve ser aceito.

BaseAdd(ConfigurationElement)

Origem:

ConfigurationElementCollection.cs

Adiciona um elemento de configuração ao 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)

Parâmetros

element

ConfigurationElement

O ConfigurationElement a ser adicionado.

Exemplos

O exemplo de código a seguir mostra como substituir o BaseAdd método e como chamá-lo de um Add método.

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

Comentários

Use o BaseAdd método para adicionar um novo ConfigurationElement à coleção. Substitua-o em uma classe derivada se o comportamento personalizado for necessário quando o elemento for adicionado.

Ao adicionar, um elemento será considerado duplicado somente se as chaves forem idênticas, mas os valores forem diferentes. Elementos com chaves e valores idênticos são aceitos silenciosamente, porque os elementos não competem. No entanto, um elemento com uma chave idêntica, mas um valor diferente não pode ser adicionado porque não há nenhuma lógica para determinar qual dos valores concorrentes deve ser aceito.

BaseAdd(ConfigurationElement, Boolean)

Origem:

ConfigurationElementCollection.cs

Adiciona um elemento de configuração à coleção de elementos de configuração.

protected public:
 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 Friend Sub BaseAdd (element As ConfigurationElement, throwIfExists As Boolean)

Parâmetros

element

ConfigurationElement

O ConfigurationElement a ser adicionado.

throwIfExists

Boolean

true para gerar uma exceção se o ConfigurationElement especificado já fizer parte de ConfigurationElementCollection, caso contrário, false.

Exceções

Exception

O ConfigurationElement a ser adicionado já existe no ConfigurationElementCollection e o parâmetro throwIfExists é true.

Comentários

Use o parâmetro throwIfExists opcional para gerar uma exceção Exception se o objeto especificado ConfigurationElement já existir na ConfigurationElementCollection coleção.

Um elemento é considerado duplicado somente se as chaves forem idênticas, mas os valores forem diferentes. Elementos com chaves e valores idênticos são aceitos silenciosamente, porque os elementos não competem. No entanto, um elemento com uma chave idêntica, mas um valor diferente não pode ser adicionado porque não há nenhuma lógica para determinar qual dos valores concorrentes deve ser aceito.

BaseAdd(Int32, ConfigurationElement)

Origem:

ConfigurationElementCollection.cs

Adiciona um elemento de configuração à coleção de elementos de configuração.

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)

Parâmetros

index

Int32

O local do índice no qual adicionar o ConfigurationElement especificado.

element

ConfigurationElement

O ConfigurationElement a ser adicionado.

Comentários

Use o index parâmetro para adicionar o ConfigurationElement objeto ao ConfigurationElementCollection em um local de índice específico.