ClientTargetCollection.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 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 la chiamata al Clear metodo dipende dal ConfigurationSaveMode valore scelto. Per aggiornare il file di configurazione, usare uno dei due metodi seguenti: Configuration.Save o Configuration.Save.

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

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

  • 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 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 add elementi definiti nei file di configurazione padre a livelli superiori nella gerarchia.

Vedi anche

• ClientTarget
• ClientTargetSection