CustomErrorCollection.Clear Método

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 CustomError objetos da CustomErrorCollection coleção. Consulte o exemplo de código no tópico de CustomErrorCollection classe para saber como obter a coleção.

// Using the Clear method.
if (!customErrorsSection.SectionInformation.IsLocked)
{
    // Execute the Clear method.
    customErrorsCollection.Clear();
    configuration.Save();
}

' Using the Clear method.
If Not customErrorsSection.SectionInformation.IsLocked Then
   ' Execute the Clear method.
   customErrorsCollection.Clear()
   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 escolhido. Para atualizar o arquivo de configuração, use uma destas duas sobrecargas: Save e Save.

Se você usar o Savemétodo ., as condições a seguir se aplicarão.

• Se você passar um 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 parâmetro Minimal, uma série de elementos remove serão adicionados ao elemento clientTarget (esquema de configurações de ASP.NET) do arquivo de configuração no nível da hierarquia atual. Cada uma remove todas as referências a um add elemento definido em um arquivo de configuração pai em um nível mais alto na hierarquia. Quando você usa Minimal, há uma propriedade adicional na coleção que afeta o que é serializado para o arquivo de configuração: EmitClear, que é false por padrão. As seguintes condições se aplicam.

  • Se o EmitClear elemento definido como true, clear for 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.

  • Se o EmitClear sinalizador estiver definido como false, o clear elemento será removido da clientTarget seção do arquivo de configuração no nível da hierarquia atual, se 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 elementos de adição definidos nos arquivos de configuração pai em níveis mais altos na hierarquia.