CustomErrorCollection.Clear Methode

public:
 void Clear();

public void Clear();

member this.Clear : unit -> unit

Public Sub Clear ()

Beispiele

Im folgenden Codebeispiel werden alle CustomError Objekte aus der CustomErrorCollection Auflistung entfernt. Weitere Informationen zum Abrufen der Auflistung finden Sie im Codebeispiel im CustomErrorCollection Klassenthema.

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

Hinweise

Das Ergebnis der Aktualisierung der Konfigurationsdatei nach dem Aufrufen der Clear Methode ist von der ConfigurationSaveMode ausgewählten Abhängigkeit. Um die Konfigurationsdatei zu aktualisieren, verwenden Sie eine der folgenden beiden Überladungen: Save und Save.

Wenn Sie die Save.-Methode verwenden, gelten die folgenden Bedingungen.

• Wenn Sie einen Full Oder Modified Parameterwert übergeben, wird ein clear Element in den clientTarget Abschnitt der Konfigurationsdatei auf der aktuellen Hierarchieebene eingefügt.

• Wenn Sie den Parameterwert Minimal übergeben, werden eine Reihe von remove-Elementen dem clientTarget-Element (ASP.NET Settings Schema) der Konfigurationsdatei auf der aktuellen Hierarchieebene hinzugefügt. Jeder entfernt alle Verweise auf ein Element, das add in einer übergeordneten Konfigurationsdatei auf einer höheren Ebene in der Hierarchie definiert ist. Wenn Sie diese Eigenschaft verwendenMinimal, gibt es eine zusätzliche Eigenschaft für die Auflistung, die sich darauf auswirkt, was in die Konfigurationsdatei serialisiert wirdEmitClear: false, die standardmäßig ist. Die folgenden Bedingungen gelten.

  • Wenn der EmitClear Satz auf true, clear element wird in den clientTarget Abschnitt der Konfigurationsdatei auf der aktuellen Hierarchieebene eingefügt. Dadurch werden alle Verweise auf die elemente entfernt, die add in den übergeordneten Konfigurationsdateien auf höheren Ebenen in der Hierarchie definiert sind.

  • Wenn das EmitClear Flag auf false festgelegt ist, wird das clear Element aus dem clientTarget Abschnitt der Konfigurationsdatei auf der aktuellen Hierarchieebene entfernt, sofern vorhanden.

Die Clear Methode löscht tatsächlich die add im clientTarget Abschnitt der Konfigurationsdatei definierten Elemente auf der aktuellen Hierarchieebene. Außerdem werden alle Verweise auf die add-Elemente entfernt, die in den übergeordneten Konfigurationsdateien auf höheren Ebenen in der Hierarchie definiert sind.