CustomErrorCollection.Clear Metod

public:
 void Clear();

public void Clear();

member this.Clear : unit -> unit

Public Sub Clear ()

Exempel

Följande kodexempel tar bort alla CustomError objekt från CustomErrorCollection samlingen. Se kodexemplet i klassavsnittet CustomErrorCollection för att lära dig hur du hämtar samlingen.

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

Kommentarer

Resultatet av att uppdatera konfigurationsfilen efter att metoden anropats Clear beror på den ConfigurationSaveMode valda metoden. Om du vill uppdatera konfigurationsfilen använder du en av dessa två överlagringar: Save och Save.

Om du använder Save.-metoden gäller följande villkor.

• Om du skickar ett värde eller ett Full parametervärde infogas ett Modified element i avsnittet i clear konfigurationsfilen på den aktuella hierarkinivånclientTarget.

• Om du skickar parametervärdet Minimal läggs en serie remove element till i clientTarget-elementet (ASP.NET Inställningsschema) för konfigurationsfilen på den aktuella hierarkinivån. Var och en tar bort alla referenser till ett add element som definierats i en överordnad konfigurationsfil på en högre nivå i hierarkin. När du använder Minimalfinns det ytterligare en egenskap i samlingen som påverkar vad som serialiseras till konfigurationsfilen: EmitClear, vilket är false som standard. Följande villkor gäller.

  • Om inställningen EmitClear till true, clear infogas elementet clientTarget i avsnittet i konfigurationsfilen på den aktuella hierarkinivån. Detta tar bort alla referenser till de add element som definierats i de överordnade konfigurationsfilerna på högre nivåer i hierarkin.

  • EmitClear Om flaggan är inställd falsepå tas elementet clear bort från clientTarget avsnittet i konfigurationsfilen på den aktuella hierarkinivån, om den finns.

Metoden Clear tar faktiskt bort de add element som definierats i clientTarget avsnittet i konfigurationsfilen på den aktuella hierarkinivån. Den tar också bort alla referenser till de tilläggselement som definierats i de överordnade konfigurationsfilerna på högre nivåer i hierarkin.