ErrObject.Clear Método

Definição

Espaço de Nomes:
Microsoft.VisualBasic
Assemblagem:
Microsoft.VisualBasic.dll

Limpa todas as definições de propriedades do Err objeto.

public:
 void Clear();
public void Clear();
member this.Clear : unit -> unit
Public Sub Clear ()

Exemplos

Este exemplo utiliza o Err método do Clear objeto para redefinir as propriedades numéricas do Err objeto para zero e as suas propriedades de string para strings de comprimento zero. Sem a chamada para Clear, a segunda chamada para MsgBox mostraria a mesma mensagem de erro.

Sub ClearErr()
  ' Produce overflow error
  On Error Resume Next
  Dim zero As Integer = 0
  Dim result As Integer = 8 / zero
  MsgBox(Err.Description)
  Err.Clear()
  MsgBox(Err.Description)
End Sub

Observações

Use Clear para limpar explicitamente o Err objeto depois de um erro ter sido tratado, como quando utiliza o tratamento diferido de erros com On Error Resume Next. O Clear método é chamado automaticamente sempre que qualquer uma das seguintes instruções é executada:

  • Qualquer tipo de Resume afirmação

  • Exit Sub, Exit Function ou Exit Property

  • Qualquer On Error afirmação

  • Qualquer Try...Catch...Finally afirmação

    Note

    O On Error Resume Next construto pode ser preferível ao On Error GoTo lidar com erros gerados durante o acesso a outros objetos. Verificar Err após cada interação com um objeto elimina a ambiguidade sobre qual objeto foi acedido pelo código: Pode ter a certeza de qual objeto colocou o código de erro em Err.Number, bem como qual o objeto que originalmente gerou o erro (o objeto especificado em Err.Source).

Aplica-se a

Ver também