ClientTargetCollection.Clear Metoda

Definice

Obor názvů:

System.Web.Configuration

Sestavení:

System.Web.dll

Odebere ClientTarget všechny objekty z kolekce.

public:
 void Clear();

public void Clear();

member this.Clear : unit -> unit

Public Sub Clear ()

Příklady

Následující příklad kódu odebere všechny ClientTarget objekty z ClientTargetCollection kolekce.

Informace o tom, jak získat kolekci, najdete v příkladu kódu v přehledu ClientTargetCollection třídy.

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

Poznámky

Výsledek aktualizace konfiguračního souboru po volání Clear metody závisí na zvolené hodnotě ConfigurationSaveMode . K aktualizaci konfiguračního souboru použijte jednu z těchto dvou metod: Configuration.Save nebo Configuration.Save.

Poznámka

Volání Configuration.Save je ekvivalentní volání Save při ConfigurationSaveMode změně hodnoty.

Pokud použijete metodu Configuration.Save , platí následující podmínky:

• Pokud předáte hodnotu parametru Full nebo Modified , vloží clear se prvek do oddílu clientTarget konfiguračního souboru na aktuální úrovni hierarchie.

• Pokud předáte hodnotu parametru Minimalremove , přidá se do oddílu clientTarget konfiguračního souboru na aktuální úrovni hierarchie řada prvků. Tím odeberete všechny odkazy na add prvky definované v nadřazených konfiguračních souborech na vyšších úrovních hierarchie. S hodnotou výčtu Minimal má jedna další vlastnost v kolekci vliv na to, co se serializuje do konfiguračního souboru. Vlastnost je EmitClear a je false ve výchozím nastavení. Platí jedna z následujících podmínek:

  • Pokud EmitClear je nastavená hodnota true, clear vloží se prvek do oddílu clientTarget konfiguračního souboru na aktuální úrovni hierarchie. Tím odeberete všechny odkazy na add prvky definované v nadřazených konfiguračních souborech na vyšších úrovních hierarchie.

  • Pokud EmitClear je nastavena na false, odebere clear se element z oddílu clientTarget konfiguračního souboru na aktuální úrovni hierarchie, pokud existuje.

Metoda Clear ve skutečnosti odstraní add prvky definované v clientTarget části konfiguračního souboru na aktuální úrovni hierarchie. Odebere také všechny odkazy na add prvky definované v nadřazených konfiguračních souborech na vyšších úrovních hierarchie.

Poznámka

Prvky add se neodstraní z oddílu clientTarget nadřazených konfiguračních souborů.

Viz také

• ClientTarget
• ClientTargetSection