ClientTargetCollection.Clear Methode

Definition

Namespace:

System.Web.Configuration

Assembly:

System.Web.dll

Entfernt alle ClientTarget-Objekte aus der Auflistung.

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 hängt vom ausgewählten Wert ab ConfigurationSaveMode . Um die Konfigurationsdatei zu aktualisieren, verwenden Sie eine der folgenden beiden Methoden: Configuration.Save oder Configuration.Save.

Hinweis

Das Aufrufen Configuration.Save entspricht dem Aufrufen Save , wenn der ConfigurationSaveMode Wert geändert wird.

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

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

• Wenn Sie den Minimal Parameterwert übergeben, wird dem clientTarget Abschnitt der Konfigurationsdatei auf der aktuellen Hierarchieebene eine Reihe von remove 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 in 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 auf truefestgelegt ist, wird auf der aktuellen Hierarchieebene ein clear Element in den clientTarget Abschnitt der Konfigurationsdatei 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 auf falsefestgelegt 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 elemente, die clientTarget im Abschnitt der Konfigurationsdatei auf der aktuellen Hierarchieebene definiert sind. Außerdem werden alle Verweise auf die Elemente entfernt, die add in den übergeordneten Konfigurationsdateien auf höheren Ebenen in der Hierarchie definiert sind.

Hinweis

Die add Elemente werden nicht aus dem Abschnitt der clientTarget übergeordneten Konfigurationsdateien gelöscht.

Weitere Informationen

• ClientTarget
• ClientTargetSection