Log.WriteException Método

Definição

Namespace:: Microsoft.VisualBasic.Logging

Assembly:: Microsoft.VisualBasic.dll

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

Nome	Description
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

Required. Exceção ao log.

Exceções

ArgumentNullException

ex é Nothing.

SecurityException

O 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. Descompacte as linhas e MsgBox as Dim linhas para causar uma NullReferenceException exceção. Para obter mais informações, consulte Como registrar exceções.

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            If Not f.InvokeRequired Then
                ' Can access the form directly.
                formTitles.Add(f.Text)
            End If
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
End Sub

Este exemplo de código só pode ser executado em um aplicativo cliente. Alterar My.Application.Log.WriteException para My.Log.WriteException 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 Como trabalhar com logs de aplicativos.

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	Veja
Escreva informações de exceção para os ouvintes de log de eventos do aplicativo.	Como registrar exceções
Determine onde `Log` grava informações.	Passo a passo: determinando onde My.Application.Log grava informações

Disponibilidade por tipo de projeto

Tipo de projeto	Available
Aplicativo do Windows	Yes
Biblioteca de Classes	Yes
Aplicativo de console	Yes
Biblioteca de Controle do Windows	Yes
Biblioteca de Controles da Web	Não
Serviço do Windows	Yes
Site da web	Yes

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

Required. Exceção ao log.

severity: TraceEventType

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

additionalInfo: String

Cadeia de caracteres a ser acrescentada à mensagem. Por predefinição, esta é uma cadeia vazia.

Exceções

ArgumentNullException

ex é Nothing.

InvalidEnumArgumentException

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

SecurityException

O 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

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            If Not f.InvokeRequired Then
                ' Can access the form directly.
                formTitles.Add(f.Text)
            End If
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
End Sub

Este exemplo de código só pode ser executado em um aplicativo cliente. Alterar My.Application.Log.WriteException para My.Log.WriteException 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 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	Veja
Escreva informações de exceção para os ouvintes de log de eventos do aplicativo.	Como registrar exceções
Determine onde `Log` grava informações.	Passo a passo: determinando onde My.Application.Log grava informações

Disponibilidade por tipo de projeto

Tipo de projeto	Available
Aplicativo do Windows	Yes
Biblioteca de Classes	Yes
Aplicativo de console	Yes
Biblioteca de Controle do Windows	Yes
Biblioteca de Controles da Web	Não
Serviço do Windows	Yes
Site da web	Yes

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

Required. Exceção ao log.

severity: TraceEventType

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

additionalInfo: String

Cadeia de caracteres a ser acrescentada à mensagem. Por predefinição, esta é uma cadeia vazia.

id: Int32

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

Exceções

ArgumentNullException

ex é Nothing.

InvalidEnumArgumentException

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

SecurityException

O 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

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            If Not f.InvokeRequired Then
                ' Can access the form directly.
                formTitles.Add(f.Text)
            End If
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
End Sub

Este exemplo de código só pode ser executado em um aplicativo cliente. Alterar My.Application.Log.WriteException para My.Log.WriteException 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 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	Veja
Escreva informações de exceção para os ouvintes de log de eventos do aplicativo.	Como registrar exceções
Determine onde `Log` grava informações.	Passo a passo: determinando onde My.Application.Log grava informações

Disponibilidade por tipo de projeto

Tipo de projeto	Available
Aplicativo do Windows	Yes
Biblioteca de Classes	Yes
Aplicativo de console	Yes
Biblioteca de Controle do Windows	Yes
Biblioteca de Controles da Web	Não
Serviço do Windows	Yes
Site da web	Yes

Confira também

Aplica-se a

Comentários

Esta página foi útil?