CustomErrorCollection.Clear Methode

Definition

Namespace:

System.Web.Configuration

Assembly:

System.Web.dll

Entfernt alle CustomError-Objekte aus der Auflistung.

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. Lesen Sie das Codebeispiel im CustomErrorCollection Klassenthema, um zu erfahren, wie Sie die Auflistung abrufen.

// 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 hängt von der ConfigurationSaveMode ausgewählten ab. Um die Konfigurationsdatei zu aktualisieren, verwenden Sie eine der beiden folgenden Überladungen: Save und Save.

Hinweis

Das Aufrufen von Save entspricht dem Aufrufen von Save.

Wenn Sie die SaveMETHODE verwenden, gelten die folgenden Bedingungen.

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

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

  • Wenn das EmitClear -Element auf truefestgelegt ist, clear 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 falsefestgelegt 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 elemente, die clientTarget im Abschnitt der Konfigurationsdatei auf der aktuellen Hierarchieebene definiert sind. Außerdem werden alle Verweise auf die add-Elemente entfernt, die in den übergeordneten Konfigurationsdateien auf höheren Ebenen in der Hierarchie definiert sind.

Hinweis

Die add Elemente werden nicht aus dem Abschnitt der clientTarget übergeordneten Konfigurationsdateien gelöscht.