CustomErrorCollection.Clear Metoda

Definice

Obor názvů:

System.Web.Configuration

Sestavení:

System.Web.dll

Odebere z kolekce všechny CustomError objekty.

public:
 void Clear();

public void Clear ();

member this.Clear : unit -> unit

Public Sub Clear ()

Příklady

Následující příklad kódu odebere CustomError všechny objekty z CustomErrorCollection kolekce. Informace o tom, jak kolekci CustomErrorCollection získat, najdete v příkladu kódu v tématu třídy.

// Using the Clear method.
if (!customErrorsSection.SectionInformation.IsLocked)
{
    // Execute the Clear method.
    customErrorsCollection.Clear();
    configuration.Save();
}

' Using the Clear method.
If Not customErrorsSection.SectionInformation.IsLocked Then
   ' Execute the Clear method.
   customErrorsCollection.Clear()
   configuration.Save()
End If

Poznámky

Výsledek aktualizace konfiguračního souboru po volání Clear metody závisí na zvolené.ConfigurationSaveMode K aktualizaci konfiguračního souboru použijte jedno z těchto dvou přetížení: Save a Save.

Poznámka

Volání Save je ekvivalentem volání Save.

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

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

• Pokud předáte Minimal hodnotu parametru, do elementu removeclientTarget (ASP.NET Schéma nastavení) konfiguračního souboru na aktuální úrovni hierarchie se přidá řada prvků. Každý odebere všechny odkazy na add prvek definovaný v nadřazené konfigurační souboru na vyšší úrovni v hierarchii. Když použijete Minimal, existuje jedna další vlastnost kolekce, která ovlivňuje to, co se serializuje do konfiguračního souboru: EmitClear, což je false ve výchozím nastavení. Platí následující podmínky.

  • Pokud je EmitClear element nastavený na true, clear vloží se 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 v hierarchii.

  • EmitClear Pokud je příznak nastavený na false, clear element se odebere 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 oddílu clientTarget konfiguračního souboru na aktuální úrovni hierarchie. Odebere také všechny odkazy na prvky přidání 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ů.