ConfigurationElementCollection.BaseAdd Método

Definición

Agrega un objeto ConfigurationElement a una instancia de ConfigurationElementCollection cuando se reemplaza en una clase derivada.Adds a ConfigurationElement to an ConfigurationElementCollection instance when overridden in a derived class.

Sobrecargas

BaseAdd(ConfigurationElement)

Agrega un elemento de configuración a la colección ConfigurationElementCollection.Adds a configuration element to the ConfigurationElementCollection.

BaseAdd(ConfigurationElement, Boolean)

Agrega un elemento de configuración a la colección de elementos de configuración.Adds a configuration element to the configuration element collection.

BaseAdd(Int32, ConfigurationElement)

Agrega un elemento de configuración a la colección de elementos de configuración.Adds a configuration element to the configuration element collection.

Comentarios

Utilice el BaseAdd método para agregar un nuevo ConfigurationElement a la colección.Use the BaseAdd method to add a new ConfigurationElement to the collection. Invalide en una clase derivada si se requiere un comportamiento personalizado al agregar el elemento.Override in a derived class if custom behavior is required when the element is added.

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.When adding, an element is considered a duplicate only if the keys are identical but the values are different. Los elementos que tienen idénticas claves y valores se aceptan sin notificación alguna porque los elementos no entran en conflicto.Elements with identical keys and values are accepted silently because the elements do not compete. 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.However, an element with an identical key but a different value cannot be added because there is no logic to determine which of the competing values should be honored.

BaseAdd(ConfigurationElement)

Agrega un elemento de configuración a la colección ConfigurationElementCollection.Adds a configuration element to the 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

ConfigurationElement que se va a agregar.The ConfigurationElement to add.

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.The following code example shows how to override the BaseAdd method and how to call it from an Add method.

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

Comentarios

Utilice el BaseAdd método para agregar un nuevo ConfigurationElement a la colección.Use the BaseAdd method to add a new ConfigurationElement to the collection. Reemplácelo en una clase derivada si se requiere un comportamiento personalizado al agregar el elemento.Override it in a derived class if custom behavior is required when the element is added.

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.When adding, an element is considered a duplicate only if the keys are identical but the values are different. Los elementos que tienen idénticas claves y valores se aceptan sin notificación alguna porque los elementos no entran en conflicto.Elements with identical keys and values are accepted silently because the elements do not compete. 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.However, an element with an identical key but a different value cannot be added because there is no logic to determine which of the competing values should be honored.

Se aplica a

BaseAdd(ConfigurationElement, Boolean)

Agrega un elemento de configuración a la colección de elementos de configuración.Adds a configuration element to the configuration element collection.

protected:
 void BaseAdd(System::Configuration::ConfigurationElement ^ element, bool throwIfExists);
protected public:
 void BaseAdd(System::Configuration::ConfigurationElement ^ element, bool throwIfExists);
protected 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 Sub BaseAdd (element As ConfigurationElement, throwIfExists As Boolean)
Protected Friend Sub BaseAdd (element As ConfigurationElement, throwIfExists As Boolean)

Parámetros

element
ConfigurationElement

ConfigurationElement que se va a agregar.The ConfigurationElement to add.

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.true to throw an exception if the ConfigurationElement specified is already contained in the ConfigurationElementCollection; otherwise, false.

Excepciones

El objeto ConfigurationElement que se quiere agregar ya existe en la colección ConfigurationElementCollection y el parámetro throwIfExists es true.The ConfigurationElement to add already exists in the ConfigurationElementCollection and the throwIfExists parameter is true.

Comentarios

Use el parámetro opcional throwIfExists para producir una Exception excepción si el ConfigurationElement objeto especificado ya existe en la ConfigurationElementCollection colección.Use the optional parameter throwIfExists to throw an Exception exception if the specified ConfigurationElement object already exists in the ConfigurationElementCollection collection.

Un elemento se considera un duplicado solo si las claves son idénticas pero los valores son diferentes.An element is considered a duplicate only if the keys are identical but the values are different. Los elementos que tienen idénticas claves y valores se aceptan sin notificación alguna porque los elementos no entran en conflicto.Elements with identical keys and values are accepted silently because the elements do not compete. 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.However, an element with an identical key but a different value cannot be added because there is no logic to determine which of the competing values should be honored.

Se aplica a

BaseAdd(Int32, ConfigurationElement)

Agrega un elemento de configuración a la colección de elementos de configuración.Adds a configuration element to the configuration element collection.

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

Ubicación del índice en el que se va a agregar el objeto ConfigurationElement especificado.The index location at which to add the specified ConfigurationElement.

element
ConfigurationElement

ConfigurationElement que se va a agregar.The ConfigurationElement to add.

Comentarios

Use el index parámetro para agregar el ConfigurationElement objeto a ConfigurationElementCollection en una ubicación de índice específica.Use the index parameter to add the ConfigurationElement object to the ConfigurationElementCollection at a specific index location.

Se aplica a