CustomErrorCollection.Clear Metoda

Definice

Obor názvů:

System.Web.Configuration

Sestavení:

System.Web.dll

Odebere všechny CustomError 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 CustomError objekty z CustomErrorCollection kolekce. Informace o tom, jak získat kolekci, najdete v příkladu CustomErrorCollection kódu v tématu předmětu.

// 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ém ConfigurationSaveMode souboru. Chcete-li aktualizovat konfigurační soubor, použijte jeden z těchto dvou přetížení: Save a Save.

Note

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

Pokud používáte metodu Save., platí následující podmínky.

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

• Pokud předáte hodnotu parametru Minimal, přidá se řada elementů remove do elementu clientTarget (schéma nastavení ASP.NET) konfiguračního souboru na aktuální úrovni hierarchie. Každý odebere všechny odkazy na add prvek definovaný v nadřazeného konfiguračním souboru na vyšší úrovni v hierarchii. Při použití Minimalexistuje jedna další vlastnost kolekce, která ovlivňuje, 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 nastavena hodnota EmitCleartrue, clear element je vložen do clientTarget oddílu konfiguračního souboru na aktuální úrovni hierarchie. Tím se odeberou 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 prvek se odebere z clientTarget oddílu konfiguračního souboru na aktuální úrovni hierarchie, pokud existuje.

Metoda Clear skutečně odstraní add prvky definované v clientTarget části 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 v hierarchii.

Note

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