ClientTargetCollection.Clear Metodo

Definizione

Spazio dei nomi:

System.Web.Configuration

Assembly:

System.Web.dll

Rimuove tutti gli oggetti ClientTarget dall'insieme.

public:
 void Clear();

public void Clear ();

member this.Clear : unit -> unit

Public Sub Clear ()

Esempio

Nell'esempio di codice seguente vengono rimossi tutti gli ClientTarget oggetti dall'insieme ClientTargetCollection .

Per informazioni su come ottenere la raccolta, vedere l'esempio di codice nella panoramica della ClientTargetCollection classe.

           // Clear the client target collection.
           clientTargets.Clear();

           // Update the configuration file.
           if (!clientTargetSection.IsReadOnly())
             configuration.Save();

' Clear the client target collection.
clientTargets.Clear()

' Update the configuration file.
If Not clientTargetSection.IsReadOnly() Then
    configuration.Save()
End If

Commenti

Il risultato dell'aggiornamento del file di configurazione dopo aver chiamato il Clear metodo dipende dal ConfigurationSaveMode valore scelto. Per aggiornare il file di configurazione, usare uno dei due metodi seguenti: Configuration.Save o Configuration.Save.

Nota

La chiamata Configuration.Save equivale a chiamare Save quando il ConfigurationSaveMode valore viene modificato.

Se si usa il Configuration.Save metodo, si applicano le condizioni seguenti:

• Se si passa il Full valore del 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, viene aggiunta una serie di elementi alla clientTarget sezione del file di remove 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. Con il valore di Minimal enumerazione, una proprietà aggiuntiva nella raccolta influisce su ciò che viene serializzato nel file di configurazione. La proprietà è ed è EmitClearfalse per impostazione predefinita. Una delle condizioni seguenti si applica:

  • Quando EmitClear è impostato su true, un clear elemento 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.

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

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 add 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.

Vedi anche

• ClientTarget
• ClientTargetSection