ClientTargetCollection.Clear Methode

public:
 void Clear();

public void Clear();

member this.Clear : unit -> unit

Public Sub Clear ()

Beispiele

Im folgenden Codebeispiel werden alle ClientTarget Objekte aus der ClientTargetCollection Auflistung entfernt.

Informationen zum Abrufen der Auflistung finden Sie im Codebeispiel in der ClientTargetCollection Klassenübersicht.

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

Hinweise

Das Ergebnis der Aktualisierung der Konfigurationsdatei nach dem Aufrufen der Clear Methode ist von dem ConfigurationSaveMode ausgewählten Wert abhängig. Zum Aktualisieren der Konfigurationsdatei verwenden Sie eine der folgenden beiden Methoden: Configuration.Save oder Configuration.Save.

Wenn Sie die Configuration.Save Methode verwenden, gelten die folgenden Bedingungen:

• Wenn Sie den Wert oder Full den Modified Parameter übergeben, wird ein clear Element in den clientTarget Abschnitt der Konfigurationsdatei auf der aktuellen Hierarchieebene eingefügt.

• Wenn Sie den Minimal Parameterwert übergeben, werden dem remove Abschnitt der Konfigurationsdatei auf der aktuellen Hierarchieebene eine Reihe von clientTarget Elementen hinzugefügt. Dadurch werden alle Verweise auf die elemente entfernt, die add in den übergeordneten Konfigurationsdateien auf höheren Ebenen in der Hierarchie definiert sind. Mit dem Minimal Enumerationswert wirkt sich eine zusätzliche Eigenschaft der Auflistung darauf aus, was in die Konfigurationsdatei serialisiert wird. Die Eigenschaft ist EmitClear und ist false standardmäßig. Eine der folgenden Bedingungen gilt:

  • Wenn EmitClear dieser Wert festgelegt trueist, wird ein clear Element in den clientTarget Abschnitt der Konfigurationsdatei auf der aktuellen Hierarchieebene eingefügt. Dadurch werden alle Verweise auf die elemente entfernt, die add in den übergeordneten Konfigurationsdateien auf höheren Ebenen in der Hierarchie definiert sind.

  • Wenn EmitClear dieses Element auf " falseFestgelegt" festgelegt ist, wird das clear Element aus dem clientTarget Abschnitt der Konfigurationsdatei auf der aktuellen Hierarchieebene entfernt, sofern vorhanden.

Die Clear Methode löscht tatsächlich die add im clientTarget Abschnitt der Konfigurationsdatei definierten Elemente auf der aktuellen Hierarchieebene. Außerdem werden alle Verweise auf die elemente entfernt, die add in den übergeordneten Konfigurationsdateien auf höheren Ebenen in der Hierarchie definiert sind.

Weitere Informationen

• ClientTarget
• ClientTargetSection