ClientTargetCollection.Clear Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee verwijdert u alle ClientTarget objecten uit de verzameling.
public:
void Clear();
public void Clear();
member this.Clear : unit -> unit
Public Sub Clear ()
Voorbeelden
In het ClientTarget volgende codevoorbeeld worden alle objecten uit de ClientTargetCollection verzameling verwijderd.
Zie het codevoorbeeld in het ClientTargetCollection klasseoverzicht voor informatie over het ophalen van de verzameling.
// 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
Opmerkingen
Het resultaat van het bijwerken van het configuratiebestand nadat de Clear methode is aangeroepen, is afhankelijk van de ConfigurationSaveMode gekozen waarde. Als u het configuratiebestand wilt bijwerken, gebruikt u een van de volgende twee methoden: Configuration.Save of Configuration.Save.
Note
Bellen komt overeen met aanroepen Configuration.SaveSave wanneer de ConfigurationSaveMode waarde wordt gewijzigd.
Als u de Configuration.Save methode gebruikt, zijn de volgende voorwaarden van toepassing:
Als u de Full waarde of Modified parameter doorgeeft, wordt een
clearelement ingevoegd in declientTargetsectie van het configuratiebestand op het huidige hiërarchieniveau.Als u de Minimal parameterwaarde doorgeeft, wordt er een reeks
removeelementen toegevoegd aan declientTargetsectie van het configuratiebestand op het huidige hiërarchieniveau. Hiermee verwijdert u alle verwijzingen naar deaddelementen die zijn gedefinieerd in de bovenliggende configuratiebestanden op hogere niveaus in de hiërarchie. Met de Minimal opsommingswaarde is één extra eigenschap in de verzameling van invloed op wat wordt geserialiseerd naar het configuratiebestand. De eigenschap is EmitClear en isfalsestandaard. Een van de volgende voorwaarden is van toepassing:Wanneer EmitClear dit is ingesteld
true, wordt eenclearelement ingevoegd in declientTargetsectie van het configuratiebestand op het huidige hiërarchieniveau. Hiermee verwijdert u alle verwijzingen naar deaddelementen die zijn gedefinieerd in de bovenliggende configuratiebestanden op hogere niveaus in de hiërarchie.Wanneer EmitClear dit is ingesteld
false, wordt hetclearelement verwijderd uit declientTargetsectie van het configuratiebestand op het huidige hiërarchieniveau, indien aanwezig.
Met Clear de methode worden de add elementen verwijderd die zijn gedefinieerd in de clientTarget sectie van het configuratiebestand op het huidige hiërarchieniveau. Ook worden alle verwijzingen naar de add elementen verwijderd die zijn gedefinieerd in de bovenliggende configuratiebestanden op hogere niveaus in de hiërarchie.
Note
De add elementen worden niet verwijderd uit de clientTarget sectie van de bovenliggende configuratiebestanden.