ClientTargetCollection.Clear Método

public:
 void Clear();

public void Clear();

member this.Clear : unit -> unit

Public Sub Clear ()

Exemplos

O seguinte exemplo de código remove todos os ClientTarget objetos da ClientTargetCollection coleção.

Para informações sobre como obter a coleção, veja o exemplo do código na ClientTargetCollection visão geral da 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

Observações

O resultado da atualização do ficheiro de configuração após chamar o Clear método depende do ConfigurationSaveMode valor escolhido. Para atualizar o ficheiro de configuração utiliza-se um destes dois métodos: Configuration.Save ou Configuration.Save.

Se utilizar o Configuration.Save método, aplicam-se as seguintes condições:

• Se passar o valor do Full parâmetro ou Modified , então um clear elemento é inserido na clientTarget secção do ficheiro de configuração ao nível da hierarquia atual.

• Se passar o valor do Minimal parâmetro, uma série de remove elementos é adicionada à clientTarget secção do ficheiro de configuração ao nível da hierarquia atual. Isto remove todas as referências aos add elementos definidos nos ficheiros de configuração pai em níveis superiores da hierarquia. Com o Minimal valor de enumeração, uma propriedade adicional na coleção afeta o que é serializado para o ficheiro de configuração. A propriedade é EmitClear e é false por defeito. Aplica-se uma das seguintes condições:

  • Quando EmitClear está definido para true, um clear elemento é inserido na clientTarget secção do ficheiro de configuração ao nível da hierarquia atual. Isto remove todas as referências aos add elementos definidos nos ficheiros de configuração pai em níveis superiores da hierarquia.

  • Quando EmitClear está definido para false, o clear elemento é removido da clientTarget secção do ficheiro de configuração ao nível hierarquial atual, caso exista.

O Clear método elimina efetivamente os add elementos definidos na clientTarget secção do ficheiro de configuração ao nível da hierarquia atual. Também remove todas as referências aos add elementos definidos nos ficheiros de configuração pai em níveis superiores da hierarquia.

Ver também

• ClientTarget
• ClientTargetSection