Log.WriteException 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.
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 -> unitPublic Sub WriteException (ex As Exception)Parâmetros
- ex
- Exception
Obrigatórios. Exceção do log.
Exceções
ex é Nothing.
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
- Exception
- TraceEventType
- Objetos (Visual Basic)
- Trabalhando com logs de aplicativo no Visual Basic
- Como registrar em log as exceções no Visual Basic
- Passo a passo: determinar o local no qual My.Application.Log grava informações
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 -> unitPublic 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
ex é Nothing.
O tipo de mensagem não é um dos valores de enumeração de TraceEventType.
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
- Exception
- TraceEventType
- Objetos (Visual Basic)
- Trabalhando com logs de aplicativo no Visual Basic
- Como registrar em log as exceções no Visual Basic
- Passo a passo: determinar o local no qual My.Application.Log grava informações
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 -> unitPublic 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
ex é Nothing.
O tipo de mensagem não é um dos valores de enumeração de TraceEventType.
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
- Exception
- TraceEventType
- Objetos (Visual Basic)
- Trabalhando com logs de aplicativo no Visual Basic
- Como registrar em log as exceções no Visual Basic
- Passo a passo: determinar o local no qual My.Application.Log grava informações
Aplica-se a
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de