CustomErrorCollection.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 CustomError objetos da CustomErrorCollection coleção. Consulta o exemplo do código no CustomErrorCollection tópico da aula para saberes 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

Observações

O resultado da atualização do ficheiro de configuração após chamar o Clear método depende do escolhido ConfigurationSaveMode . Para atualizar o ficheiro de configuração, utiliza-se uma destas duas sobrecargas: Save e Save.

Se usar o Savemétodo ., aplicam-se as seguintes condições.

• Se passar um Full valor de 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 parâmetro Minimal, uma série de elementos remove é adicionada ao clientTarget Element (ASP.NET Settings Schema) do ficheiro de configuração ao nível da hierarquia atual. Cada um remove todas as referências a um add elemento definido num ficheiro de configuração pai a um nível superior da hierarquia. Quando usa Minimal, há uma propriedade adicional na coleção que afeta o que é serializado para o ficheiro de configuração: EmitClear, que é false por defeito. Aplicam-se as seguintes condições.

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

  • Se a EmitClear flag for definida para false, o clear elemento é removido da clientTarget secção do ficheiro de configuração ao nível da hierarquia 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 elementos adicionais definidos nos ficheiros de configuração pai em níveis superiores da hierarquia.