Log.WriteException Método

  • Referência

Definição

Namespace:
Microsoft.VisualBasic.Logging
Assembly:
Microsoft.VisualBasic.dll
Assembly:
Microsoft.VisualBasic.Forms.dll

Grava informações de exceção nos ouvintes de log do aplicativo.

Sobrecargas

WriteException(Exception)

Grava informações de exceção nos ouvintes de log do aplicativo.
WriteException(Exception, TraceEventType, String)

Grava informações de exceção nos ouvintes de log do aplicativo.
WriteException(Exception, TraceEventType, String, Int32)

Grava informações de exceção nos ouvintes de log do aplicativo.

WriteException(Exception)

Grava informações de exceção nos ouvintes de log do aplicativo.

public:
 void WriteException(Exception ^ ex);
public void WriteException (Exception ex);
member this.WriteException : Exception -> unit
Public Sub WriteException (ex As Exception)

Parâmetros

ex
Exception

Obrigatórios. Exceção do log.

Exceções

ArgumentNullException

ex é Nothing.

SecurityException

Código com confiança parcial chama o método, mas grava em um ouvinte de log de eventos que requer confiança total.

Exemplos

Este exemplo mostra como usar o My.Application.Log.WriteException método para registrar exceções em log. Remova a marca de comentário das linhas Dim e MsgBox para lançar uma exceção NullReferenceException. Para obter mais informações, consulte Como registrar exceções em log.

Public Sub ExceptionLogTest(ByVal fileName As String)
    Try
        ' Code that might generate an exception goes here.
        ' For example:
        '    Dim x As Object
        '    MsgBox(x.ToString)
    Catch ex As Exception
        My.Application.Log.WriteException(ex, 
            TraceEventType.Error, 
            "Exception in ExceptionLogTest " & 
            "with argument " & fileName & ".")
    End Try
End Sub

Este exemplo de código só pode ser executado em um aplicativo cliente. Altere My.Application.Log.WriteException para My.Log.WriteException para aplicativos Web.

Comentários

O WriteException método grava as informações contidas em uma exceção para os ouvintes de log de eventos do aplicativo.

Em aplicativos cliente, o Log objeto está disponível por meio do My.Application.Log objeto . Em aplicativos Web, o Log objeto está disponível por meio do My.Log objeto .

Para saber quais ouvintes de log recebem as WriteException mensagens do método, consulte Passo a passo: determinando onde My.Application.Log grava informações. Você pode alterar os ouvintes de log padrão. Para obter mais informações, consulte Working with Application Logs (Trabalhando com logs de aplicativo).

Para sobrecargas que não levam o id argumento , o identificador gravado no log é definido pela tabela a seguir.

severity Padrão id
Information 0
Warning 1
Error 2
Critical 3
Start 4
Stop 5
Suspend 6
Resume 7
Verbose 8
Transfer 9

A tabela a seguir lista exemplos de tarefas que envolvem o WriteException método .

Para Consulte
Escreva informações de exceção para os ouvintes de log de eventos do aplicativo. Como: registrar exceções em log
Determine o local em que Log grava as informações. Passo a passo: determinar o local no qual My.Application.Log grava informações

Disponibilidade por tipo de projeto

Tipo de projeto Disponível
Aplicativo do Windows Sim
Biblioteca de Classes Sim
Aplicativo do Console Sim
Biblioteca de Controle do Windows Sim
Biblioteca de Controles da Web Não
Serviço do Windows Sim
Site Sim

Confira também

Aplica-se a

WriteException(Exception, TraceEventType, String)

Grava informações de exceção nos ouvintes de log do aplicativo.

public:
 void WriteException(Exception ^ ex, System::Diagnostics::TraceEventType severity, System::String ^ additionalInfo);
public void WriteException (Exception ex, System.Diagnostics.TraceEventType severity, string additionalInfo);
member this.WriteException : Exception * System.Diagnostics.TraceEventType * string -> unit
Public Sub WriteException (ex As Exception, severity As TraceEventType, additionalInfo As String)

Parâmetros

ex
Exception

Obrigatórios. Exceção do log.

severity
TraceEventType

O tipo de mensagem. Por padrão, Error.

additionalInfo
String

Cadeia de caracteres a acrescentar à mensagem. Por padrão, é uma cadeia de caracteres vazia.

Exceções

ArgumentNullException

ex é Nothing.

InvalidEnumArgumentException

O tipo de mensagem não é um dos valores de enumeração de TraceEventType.

SecurityException

Código com confiança parcial chama o método, mas grava em um ouvinte de log de eventos que requer confiança total.

Exemplos

Este exemplo mostra como usar o My.Application.Log.WriteException método para registrar exceções em log. Remova a marca de comentário das linhas Dim e MsgBox para lançar uma exceção NullReferenceException. Para obter mais informações, consulte Como registrar exceções em log.

Public Sub ExceptionLogTest(ByVal fileName As String)
    Try
        ' Code that might generate an exception goes here.
        ' For example:
        '    Dim x As Object
        '    MsgBox(x.ToString)
    Catch ex As Exception
        My.Application.Log.WriteException(ex, 
            TraceEventType.Error, 
            "Exception in ExceptionLogTest " & 
            "with argument " & fileName & ".")
    End Try
End Sub

Este exemplo de código só pode ser executado em um aplicativo cliente. Altere My.Application.Log.WriteException para My.Log.WriteException para aplicativos Web.

Comentários

O WriteException método grava as informações contidas em uma exceção para os ouvintes de log de eventos do aplicativo.

Em aplicativos cliente, o Log objeto está disponível por meio do My.Application.Log objeto . Em aplicativos Web, o Log objeto está disponível por meio do My.Log objeto .

Para saber quais ouvintes de log recebem as WriteException mensagens do método, consulte Passo a passo: determinando onde My.Application.Log grava informações. Você pode alterar os ouvintes de log padrão. Para obter mais informações, consulte Working with Application Logs (Trabalhando com logs de aplicativo).

Para sobrecargas que não levam o id argumento , o identificador gravado no log é definido pela tabela a seguir.

severity Padrão id
Information 0
Warning 1
Error 2
Critical 3
Start 4
Stop 5
Suspend 6
Resume 7
Verbose 8
Transfer 9

A tabela a seguir lista exemplos de tarefas que envolvem o WriteException método .

Para Consulte
Escreva informações de exceção para os ouvintes de log de eventos do aplicativo. Como: registrar exceções em log
Determine o local em que Log grava as informações. Passo a passo: determinar o local no qual My.Application.Log grava informações

Disponibilidade por tipo de projeto

Tipo de projeto Disponível
Aplicativo do Windows Sim
Biblioteca de Classes Sim
Aplicativo do Console Sim
Biblioteca de Controle do Windows Sim
Biblioteca de Controles da Web Não
Serviço do Windows Sim
Site Sim

Confira também

Aplica-se a

WriteException(Exception, TraceEventType, String, Int32)

Grava informações de exceção nos ouvintes de log do aplicativo.

public:
 void WriteException(Exception ^ ex, System::Diagnostics::TraceEventType severity, System::String ^ additionalInfo, int id);
public void WriteException (Exception ex, System.Diagnostics.TraceEventType severity, string additionalInfo, int id);
member this.WriteException : Exception * System.Diagnostics.TraceEventType * string * int -> unit
Public Sub WriteException (ex As Exception, severity As TraceEventType, additionalInfo As String, id As Integer)

Parâmetros

ex
Exception

Obrigatórios. Exceção do log.

severity
TraceEventType

O tipo de mensagem. Por padrão, Error.

additionalInfo
String

Cadeia de caracteres a acrescentar à mensagem. Por padrão, é uma cadeia de caracteres vazia.

id
Int32

Identificador de mensagem, normalmente usado para correlação. Por padrão, relacionado a entryType conforme descrito na tabela na seção Comentários.

Exceções

ArgumentNullException

ex é Nothing.

InvalidEnumArgumentException

O tipo de mensagem não é um dos valores de enumeração de TraceEventType.

SecurityException

Código com confiança parcial chama o método, mas grava em um ouvinte de log de eventos que requer confiança total.

Exemplos

Este exemplo mostra como usar o My.Application.Log.WriteException método para registrar exceções em log. Remova a marca de comentário das linhas Dim e MsgBox para lançar uma exceção NullReferenceException. Para obter mais informações, consulte Como registrar exceções em log.

Public Sub ExceptionLogTest(ByVal fileName As String)
    Try
        ' Code that might generate an exception goes here.
        ' For example:
        '    Dim x As Object
        '    MsgBox(x.ToString)
    Catch ex As Exception
        My.Application.Log.WriteException(ex, 
            TraceEventType.Error, 
            "Exception in ExceptionLogTest " & 
            "with argument " & fileName & ".")
    End Try
End Sub

Este exemplo de código só pode ser executado em um aplicativo cliente. Altere My.Application.Log.WriteException para My.Log.WriteException para aplicativos Web.

Comentários

O WriteException método grava as informações contidas em uma exceção para os ouvintes de log de eventos do aplicativo.

Em aplicativos cliente, o Log objeto está disponível por meio do My.Application.Log objeto . Em aplicativos Web, o Log objeto está disponível por meio do My.Log objeto .

Para saber quais ouvintes de log recebem as WriteException mensagens do método, consulte Passo a passo: determinando onde My.Application.Log grava informações. Você pode alterar os ouvintes de log padrão. Para obter mais informações, consulte Working with Application Logs (Trabalhando com logs de aplicativo).

Para sobrecargas que não levam o id argumento , o identificador gravado no log é definido pela tabela a seguir.

severity Padrão id
Information 0
Warning 1
Error 2
Critical 3
Start 4
Stop 5
Suspend 6
Resume 7
Verbose 8
Transfer 9

A tabela a seguir lista exemplos de tarefas que envolvem o WriteException método .

Para Consulte
Escreva informações de exceção para os ouvintes de log de eventos do aplicativo. Como: registrar exceções em log
Determine o local em que Log grava as informações. Passo a passo: determinar o local no qual My.Application.Log grava informações

Disponibilidade por tipo de projeto

Tipo de projeto Disponível
Aplicativo do Windows Sim
Biblioteca de Classes Sim
Aplicativo do Console Sim
Biblioteca de Controle do Windows Sim
Biblioteca de Controles da Web Não
Serviço do Windows Sim
Site Sim

Confira também

Aplica-se a