Information.Err Método

Definição

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

Contém informações sobre erros em tempo de execução.

public:
 static Microsoft::VisualBasic::ErrObject ^ Err();
public static Microsoft.VisualBasic.ErrObject Err();
static member Err : unit -> Microsoft.VisualBasic.ErrObject
Public Function Err () As ErrObject

Devoluções

ErrObject

Contém informações sobre erros em tempo de execução.

Exemplos

Este exemplo utiliza as propriedades do Err objeto na construção de uma caixa de diálogo de mensagem de erro. Note que, se usar primeiro o método Clear, ao gerar um erro de Visual Basic com o método Raise, os valores padrão da Visual Basic tornam-se as propriedades do objeto Err.

Dim Msg As String
' If an error occurs, construct an error message.
On Error Resume Next   ' Defer error handling.
Err.Clear()
Err.Raise(6)   ' Generate an "Overflow" error.
' Check for error, then show message.
If Err.Number <> 0 Then
  Msg = "Error # " & Str(Err.Number) & " was generated by " &
        Err.Source & ControlChars.CrLf & Err.Description
  MsgBox(Msg, MsgBoxStyle.Information, "Error")
End If

Observações

As propriedades do objeto Err são definidas pelo gerador de um erro – Visual Basic, um objeto ou o programador.

Quando ocorre um erro em tempo de execução, as propriedades do Err objeto são preenchidas com informação que identifica de forma única o erro e que pode usar para lidar com o erro. Para gerar um erro em tempo de execução no seu código, use o Raise método.

As Err propriedades do objeto são redefinidas para cadeias de comprimento zero ou zero ("") após uma Exit Subinstrução , Exit Function, Exit Property, ou Resume Next dentro de uma rotina de tratamento de erros. Usar qualquer forma da Resume instrução fora de uma rotina de tratamento de erros não irá reiniciar as Err propriedades do objeto. Pode usar o Clear método para reiniciar Errexplicitamente .

Use o Raise método em vez da Error instrução para gerar erros em tempo de execução para erros de sistema e módulos de classe. A tua decisão sobre usar o Raise método noutro código depende da riqueza da informação que queres devolver.

O Err objeto é um objeto intrínseco com âmbito global. Portanto, não precisa de criar uma instância dele no seu código.

Aplica-se a

Ver também