ClientTargetCollection.Clear Método

Definição

Namespace:

System.Web.Configuration

Assembly:

System.Web.dll

Remove todos os objetos ClientTarget da coleção.

public:
 void Clear();

public void Clear ();

member this.Clear : unit -> unit

Public Sub Clear ()

Exemplos

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

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

Comentários

O resultado da atualização do arquivo de configuração depois de chamar o Clear método depende do ConfigurationSaveMode valor escolhido. Para atualizar o arquivo de configuração, você usa um destes dois métodos: Configuration.Save ou Configuration.Save.

Observação

A chamada Configuration.Save é equivalente à chamada Save quando o ConfigurationSaveMode valor é modificado.

Se você usar o Configuration.Save método, as seguintes condições se aplicam:

• Se você passar o Full valor ou Modified parâmetro, um clear elemento será inserido na clientTarget seção do arquivo de configuração no nível da hierarquia atual.

• Se você passar o valor do Minimal parâmetro, uma série de remove elementos será adicionada à clientTarget seção do arquivo de configuração no nível da hierarquia atual. Isso remove todas as referências aos add elementos definidos nos arquivos de configuração pai em níveis mais altos na hierarquia. Com o valor de Minimal enumeração, uma propriedade adicional na coleção afeta o que é serializado para o arquivo de configuração. A propriedade é EmitClear e é false por padrão. Uma das seguintes condições se aplica:

  • Quando EmitClear é definido como true, um clear elemento é inserido na clientTarget seção do arquivo de configuração no nível da hierarquia atual. Isso remove todas as referências aos add elementos definidos nos arquivos de configuração pai em níveis mais altos na hierarquia.

  • Quando EmitClear é definido como false, o clear elemento é removido da clientTarget seção do arquivo de configuração no nível da hierarquia atual, se ele existir.

O Clear método realmente exclui os add elementos definidos na clientTarget seção do arquivo de configuração no nível da hierarquia atual. Ele também remove todas as referências aos add elementos definidos nos arquivos de configuração pai em níveis mais altos na hierarquia.

Observação

Os add elementos não são excluídos da clientTarget seção dos arquivos de configuração pai.

Confira também

• ClientTarget
• ClientTargetSection