CustomErrorCollection.Clear Metodo

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.

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

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

• Se si passa il valore del parametro , viene aggiunta una serie di elementi /> clientTarget (schema impostazioni ASP.NET) del file di configurazione a livello di gerarchia corrente. Ognuno 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 su ciò che viene serializzato nel file di configurazione: EmitClear, che è false per impostazione predefinita. Si applicano le condizioni seguenti.

  • Se l'oggetto è impostato su EmitClear, true l'elemento clear 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 agli elementi di aggiunta definiti nei file di configurazione padre a livelli superiori nella gerarchia.