ClientTargetCollection.Clear Metod

Definition

Tar bort alla ClientTarget objekt från samlingen.

public:
 void Clear();
public void Clear();
member this.Clear : unit -> unit
Public Sub Clear ()

Exempel

Följande kodexempel tar bort alla ClientTarget objekt från ClientTargetCollection samlingen.

Information om hur du hämtar samlingen finns i kodexemplet i klassöversikten ClientTargetCollection .


           // 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

Kommentarer

Resultatet av att uppdatera konfigurationsfilen efter att metoden anropats Clear beror på det ConfigurationSaveMode valda värdet. Om du vill uppdatera konfigurationsfilen använder du någon av dessa två metoder: Configuration.Save eller Configuration.Save.

Note

Anrop Configuration.Save motsvarar anrop Save när ConfigurationSaveMode värdet ändras.

Om du använder Configuration.Save metoden gäller följande villkor:

  • Om du skickar Full parametervärdet eller Modified infogas ett clear element i avsnittet i clientTarget konfigurationsfilen på den aktuella hierarkinivån.

  • Om du skickar Minimal parametervärdet läggs en serie remove element till i clientTarget avsnittet i konfigurationsfilen på den aktuella hierarkinivån. Detta tar bort alla referenser till de add element som definierats i de överordnade konfigurationsfilerna på högre nivåer i hierarkin. Minimal Med uppräkningsvärdet påverkar en ytterligare egenskap i samlingen vad som serialiseras till konfigurationsfilen. Egenskapen är EmitClear och är false som standard. Ett av följande villkor gäller:

    • När EmitClear är inställt truepå infogas ett clear element i clientTarget avsnittet i konfigurationsfilen på den aktuella hierarkinivån. Detta tar bort alla referenser till de add element som definierats i de överordnade konfigurationsfilerna på högre nivåer i hierarkin.

    • När EmitClear är inställt falsepå tas elementet clear bort från clientTarget avsnittet i konfigurationsfilen på den aktuella hierarkinivån, om det finns.

Metoden Clear tar faktiskt bort de add element som definierats i clientTarget avsnittet i konfigurationsfilen på den aktuella hierarkinivån. Den tar också bort alla referenser till de add element som definierats i de överordnade konfigurationsfilerna på högre nivåer i hierarkin.

Note

Elementen add tas inte bort från clientTarget avsnittet i de överordnade konfigurationsfilerna.

Gäller för

Se även