CustomErrorCollection.Clear Metodo

Definizione

Spazio dei nomi:

System.Web.Configuration

Assembly:

System.Web.dll

Rimuove tutti gli oggetti CustomError dalla raccolta.

public:
 void Clear();

public void Clear ();

member this.Clear : unit -> unit

Public Sub Clear ()

Esempio

Nell'esempio di codice seguente vengono rimossi tutti gli CustomError oggetti dall'insieme CustomErrorCollection . Fare riferimento all'esempio di codice nell'argomento della CustomErrorCollection classe per informazioni su come ottenere la raccolta.

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

Commenti

Il risultato dell'aggiornamento del file di configurazione dopo la chiamata al Clear metodo dipende dall'oggetto ConfigurationSaveMode scelto. Per aggiornare il file di configurazione, usare uno di questi due overload: Save e Save.

Nota

La chiamata di Save equivale alla chiamata di Save.

Se si usa il Savemetodo ., si applicano le condizioni seguenti.

• Se si passa un valore di Full parametro o Modified , un clear elemento viene inserito nella clientTarget sezione del file di configurazione a livello di gerarchia corrente.

• Se si passa il valore del Minimal parametro, una serie di remove elementi viene aggiunta all'elemento clientTarget (schema delle impostazioni ASP.NET) del file di configurazione a livello di gerarchia corrente. Ogni rimuove tutti i riferimenti a un add elemento definito in un file di configurazione padre a un livello superiore nella gerarchia. Quando si usa Minimal, è presente una proprietà aggiuntiva nella raccolta che influisce sugli elementi serializzati nel file di configurazione: EmitClear, che è per false impostazione predefinita. Si applicano le condizioni seguenti.

  • Se l'oggetto è impostato su true, clear l'elemento EmitClear viene inserito nella clientTarget sezione del file di configurazione a livello di gerarchia corrente. In questo modo vengono rimossi tutti i riferimenti agli add elementi definiti nei file di configurazione padre a livelli superiori nella gerarchia.

  • Se il EmitClear flag è impostato su false, l'elemento clear viene rimosso dalla clientTarget sezione del file di configurazione a livello di gerarchia corrente, se esistente.

Il Clear metodo elimina effettivamente gli add elementi definiti nella clientTarget sezione del file di configurazione a livello di gerarchia corrente. Rimuove anche tutti i riferimenti all'aggiunta di elementi definiti nei file di configurazione padre a livelli superiori nella gerarchia.

Nota

Gli add elementi non vengono eliminati dalla clientTarget sezione dei file di configurazione padre.