ClientTargetCollection.Clear Método

Definición

Espacio de nombres:

System.Web.Configuration

Ensamblado:

System.Web.dll

Quita todos los objetos ClientTarget 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 ClientTarget objetos de la ClientTargetCollection colección.

Para obtener información sobre cómo obtener la colección, vea el ejemplo de código en la información general de la ClientTargetCollection clase.

           // Clear the client target collection.
           clientTargets.Clear();

           // Update the configuration file.
           if (!clientTargetSection.IsReadOnly())
             configuration.Save();

' Clear the client target collection.
clientTargets.Clear()

' Update the configuration file.
If Not clientTargetSection.IsReadOnly() Then
    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 valor elegido. Para actualizar el archivo de configuración, use uno de estos dos métodos: Configuration.Save o Configuration.Save.

Nota

La llamada Configuration.Save es equivalente a llamar Save a cuando se modifica el ConfigurationSaveMode valor.

Si usa el Configuration.Save método , se aplican las condiciones siguientes:

• Si pasa el Full valor del 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 agregará una serie de remove elementos a la clientTarget sección del archivo de configuración en el nivel de 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. Con el Minimal valor de enumeración, una propiedad adicional de la colección afecta a lo que se serializa en el archivo de configuración. La propiedad es EmitClear y es false de forma predeterminada. Se aplica una de las condiciones siguientes:

  • Cuando EmitClear se establece trueen , se inserta un clear elemento en la clientTarget sección del archivo de configuración en el nivel de 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.

  • Cuando EmitClear 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 add elementos 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.

Consulte también

• ClientTarget
• ClientTargetSection