ClientTargetCollection.Clear Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 nellaclientTarget
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 diremove
configurazione a livello di gerarchia corrente. In questo modo vengono rimossi tutti i riferimenti agliadd
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
, unclear
elemento viene inserito nellaclientTarget
sezione del file di configurazione a livello di gerarchia corrente. In questo modo vengono rimossi tutti i riferimenti agliadd
elementi definiti nei file di configurazione padre a livelli superiori nella gerarchia.Quando EmitClear è impostato su
false
, l'elementoclear
viene rimosso dallaclientTarget
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.