CustomErrorCollection.Clear Método

Definição

Namespace:

System.Web.Configuration

Assembly:

System.Web.dll

Remove todos os objetos CustomError 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 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.

Observação

Chamar Save é equivalente a chamar Save.

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

• Se você passar um Full valor de parâmetro ou Modified , 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 ao elemento clientTarget (esquema de configurações 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 definido como true, clear o elemento será 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 for definido falsecomo , o clear elemento será removido da clientTarget seção do arquivo de configuração no nível da hierarquia atual, se ele existir.

Na Clear verdade, o método 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.

Observação

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