CustomErrorCollection.Clear Método

Definición

Espacio de nombres:

System.Web.Configuration

Ensamblado:

System.Web.dll

Quita todos los objetos CustomError de la colección.

public:
 void Clear();

public void Clear ();

member this.Clear : unit -> unit

Public Sub Clear ()

Ejemplos

En el ejemplo de código siguiente se quitan todos los CustomError objetos de la CustomErrorCollection colección. Consulte el ejemplo de código del tema de clase CustomErrorCollection para obtener información sobre cómo obtener la colección.

// Using the Clear method.
if (!customErrorsSection.SectionInformation.IsLocked)
{
    // Execute the Clear method.
    customErrorsCollection.Clear();
    configuration.Save();
}

' Using the Clear method.
If Not customErrorsSection.SectionInformation.IsLocked Then
   ' Execute the Clear method.
   customErrorsCollection.Clear()
   configuration.Save()
End If

Comentarios

El resultado de actualizar el archivo de configuración después de llamar al Clear método depende del ConfigurationSaveMode elegido. Para actualizar el archivo de configuración, use una de estas dos sobrecargas: Save y Save.

Nota

Llamar a Save es equivalente a llamar a Save.

Si usa el Save.method, se aplican las condiciones siguientes.

• Si pasa un Full valor de parámetro o Modified , se inserta un clear elemento en la clientTarget sección del archivo de configuración en el nivel de jerarquía actual.

• Si pasa el valor del Minimal parámetro, se agrega una serie de remove elementos al elemento clientTarget (ASP.NET Configuración Schema) del archivo de configuración en el nivel de jerarquía actual. Cada una quita todas las referencias a un add elemento definido en un archivo de configuración primario en un nivel superior de la jerarquía. Cuando se usa Minimal, hay una propiedad adicional en la colección que afecta a lo que se serializa en el archivo de configuración: EmitClear, que es false de forma predeterminada. Se aplican las siguientes condiciones.

  • Si se EmitClear establece en , clear el elemento se inserta en la clientTarget sección del archivo de configuración en el nivel truede jerarquía actual. Esto quita todas las referencias a los add elementos definidos en los archivos de configuración primarios en niveles superiores de la jerarquía.

  • Si la EmitClear marca se establece falseen , el clear elemento se quita de la clientTarget sección del archivo de configuración en el nivel de jerarquía actual, si existe.

El Clear método elimina realmente los add elementos definidos en la clientTarget sección del archivo de configuración en el nivel de jerarquía actual. También quita todas las referencias a los elementos add definidos en los archivos de configuración primarios en niveles superiores de la jerarquía.

Nota

Los add elementos no se eliminan de la clientTarget sección de los archivos de configuración primarios.