Information.Err Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Contém informações sobre erros de 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
Retornos
Contém informações sobre erros de tempo de execução.
Exemplos
Este exemplo usa as propriedades do Err
objeto na construção de uma caixa de diálogo de mensagem de erro. Observe que, se você usar o Clear
método primeiro, ao gerar um erro do Visual Basic com o método , os Raise
valores padrão do Visual Basic se tornarão as propriedades do Err
objeto.
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
Comentários
As propriedades do Err
objeto 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ções que identificam exclusivamente o erro e que você pode usar para lidar com o erro. Para gerar um erro em tempo de execução em seu código, use o Raise
método .
As Err
propriedades do objeto são redefinidas para cadeias de caracteres de comprimento zero ou zero ("") após uma instrução Exit Sub
, 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 redefinirá as Err
propriedades do objeto. Você pode usar o Clear
método para redefinir Err
explicitamente .
Use o Raise
método em vez da Error
instrução para gerar erros em tempo de execução para erros do sistema e módulos de classe. Sua decisão sobre usar o Raise
método em outro código depende da riqueza das informações que você deseja retornar.
O Err
objeto é um objeto intrínseco com escopo global. Portanto, você não precisa criar uma instância dela em seu código.