ConfigurationElementCollection.BaseAdd Método

Definición

Espacio de nombres:

System.Configuration

Ensamblado:

System.Configuration.ConfigurationManager.dll

Paquete:

System.Configuration.ConfigurationManager v8.0.0

Agrega un objeto ConfigurationElement a una instancia de ConfigurationElementCollection cuando se reemplaza en una clase derivada.

Sobrecargas

BaseAdd(ConfigurationElement)	Agrega un elemento de configuración a la colección ConfigurationElementCollection.
BaseAdd(ConfigurationElement, Boolean)	Agrega un elemento de configuración a la colección de elementos de configuración.
BaseAdd(Int32, ConfigurationElement)	Agrega un elemento de configuración a la colección de elementos de configuración.

Comentarios

Use el BaseAdd método para agregar un nuevo ConfigurationElement elemento a la colección. Invalide en una clase derivada si se requiere un comportamiento personalizado cuando se agrega el elemento.

Al agregar, se considera que un elemento es un duplicado de otro sólo en el caso de que sus claves sean idénticas y sus valores diferentes. Los elementos que tienen idénticas claves y valores se aceptan sin notificación alguna porque los elementos no entran en conflicto. Sin embargo, no se puede agregar un elemento que tenga la misma clave que otro pero un valor diferente porque no hay una lógica para determinar cuál de los valores en conflicto debe prevalecer.

BaseAdd(ConfigurationElement)

Source:

ConfigurationElementCollection.cs

Agrega un elemento de configuración a la colección ConfigurationElementCollection.

C#

protected virtual void BaseAdd (System.Configuration.ConfigurationElement element);

Parámetros

element

ConfigurationElement

ConfigurationElement que se va a agregar.

Ejemplos

En el ejemplo de código siguiente se muestra cómo invalidar el BaseAdd método y cómo llamarlo desde un Add método .

C#

public void Add(UrlConfigElement url)
{
    BaseAdd(url);

    // Your custom code goes here.
}

Comentarios

Use el BaseAdd método para agregar un nuevo ConfigurationElement elemento a la colección. Invalide en una clase derivada si se requiere un comportamiento personalizado cuando se agrega el elemento.

Al agregar, se considera que un elemento es un duplicado de otro sólo en el caso de que sus claves sean idénticas y sus valores diferentes. Los elementos que tienen idénticas claves y valores se aceptan sin notificación alguna porque los elementos no entran en conflicto. Sin embargo, no se puede agregar un elemento que tenga la misma clave que otro pero un valor diferente porque no hay una lógica para determinar cuál de los valores en conflicto debe prevalecer.

BaseAdd(ConfigurationElement, Boolean)

Source:

ConfigurationElementCollection.cs

Agrega un elemento de configuración a la colección de elementos de configuración.

C#

protected internal void BaseAdd (System.Configuration.ConfigurationElement element, bool throwIfExists);

Parámetros

element

ConfigurationElement

ConfigurationElement que se va a agregar.

throwIfExists

Boolean

Es true para producir una excepción si el objeto ConfigurationElement especificado ya está incluido en el objeto ConfigurationElementCollection; de lo contrario, es false.

Excepciones

Exception

El objeto ConfigurationElement que se quiere agregar ya existe en la colección ConfigurationElementCollection y el parámetro throwIfExists es true.

Comentarios

Use el parámetro throwIfExists opcional para producir una Exception excepción si el objeto especificado ConfigurationElement ya existe en la ConfigurationElementCollection colección.

Un elemento se considera duplicado solo si las claves son idénticas, pero los valores son diferentes. Los elementos que tienen idénticas claves y valores se aceptan sin notificación alguna porque los elementos no entran en conflicto. Sin embargo, no se puede agregar un elemento que tenga la misma clave que otro pero un valor diferente porque no hay una lógica para determinar cuál de los valores en conflicto debe prevalecer.

BaseAdd(Int32, ConfigurationElement)

Source:

ConfigurationElementCollection.cs

Agrega un elemento de configuración a la colección de elementos de configuración.

C#

protected virtual void BaseAdd (int index, System.Configuration.ConfigurationElement element);

Parámetros

index

Int32

Ubicación del índice en el que se va a agregar el objeto ConfigurationElement especificado.

element

ConfigurationElement

ConfigurationElement que se va a agregar.

Comentarios

Use el index parámetro para agregar el ConfigurationElement objeto a ConfigurationElementCollection en una ubicación de índice específica.