CustomErrorCollection.Clear Methode

Definitie

Naamruimte:

System.Web.Configuration

Assembly:

System.Web.dll

Hiermee verwijdert u alle CustomError objecten uit de verzameling.

public:
 void Clear();

public void Clear();

member this.Clear : unit -> unit

Public Sub Clear ()

Voorbeelden

In het CustomError volgende codevoorbeeld worden alle objecten uit de CustomErrorCollection verzameling verwijderd. Raadpleeg het codevoorbeeld in het CustomErrorCollection klasseonderwerp voor meer informatie over het ophalen van de verzameling.

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

Opmerkingen

Het resultaat van het bijwerken van het configuratiebestand nadat de Clear methode is aangeroepen, is afhankelijk van de ConfigurationSaveMode gekozen methode. Als u het configuratiebestand wilt bijwerken, gebruikt u een van deze twee overbelastingen: Save en Save.

Note

Bellen Save is gelijk aan bellen Save.

Als u de Save.method gebruikt, zijn de volgende voorwaarden van toepassing.

• Als u een Full waarde of Modified parameter doorgeeft, wordt een clear element ingevoegd in de clientTarget sectie van het configuratiebestand op het huidige hiërarchieniveau.

• Als u de parameterwaarde Minimal doorgeeft, worden er een reeks remove-elementen toegevoegd aan het element clientTarget (ASP.NET Settings Schema) van het configuratiebestand op het huidige hiërarchieniveau. Elk verwijdert alle verwijzingen naar een add element dat is gedefinieerd in een bovenliggend configuratiebestand op een hoger niveau in de hiërarchie. Wanneer u gebruikt Minimal, is er een extra eigenschap voor de verzameling die van invloed is op wat wordt geserialiseerd naar het configuratiebestand: EmitClear, wat standaard is false . De volgende voorwaarden zijn van toepassing.

  • Als de EmitClear set is trueingesteld op, clear wordt het element ingevoegd in de clientTarget sectie van het configuratiebestand op het huidige hiërarchieniveau. Hiermee verwijdert u alle verwijzingen naar de add elementen die zijn gedefinieerd in de bovenliggende configuratiebestanden op hogere niveaus in de hiërarchie.

  • Als de EmitClear vlag is ingesteld op false, wordt het clear element verwijderd uit de clientTarget sectie van het configuratiebestand op het huidige hiërarchieniveau, indien aanwezig.

Met Clear de methode worden de add elementen verwijderd die zijn gedefinieerd in de clientTarget sectie van het configuratiebestand op het huidige hiërarchieniveau. Ook worden alle verwijzingen verwijderd naar de elementen die zijn gedefinieerd in de bovenliggende configuratiebestanden op hogere niveaus in de hiërarchie.

Note

De add elementen worden niet verwijderd uit de clientTarget sectie van de bovenliggende configuratiebestanden.