Log.WriteException Método

Definição

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

Escreve informações de exceção para os ouvintes de registo da aplicação.

Sobrecargas

Name Description
WriteException(Exception)

Escreve informações de exceção para os ouvintes de registo da aplicação.
WriteException(Exception, TraceEventType, String)

Escreve informações de exceção para os ouvintes de registo da aplicação.
WriteException(Exception, TraceEventType, String, Int32)

Escreve informações de exceção para os ouvintes de registo da aplicação.

WriteException(Exception)

Escreve informações de exceção para os ouvintes de registo da aplicação.

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 registo.

Exceções

ArgumentNullException

ex é Nothing.

SecurityException

Código com confiança parcial chama o método, mas escreve num ouvinte de registo de eventos que requer total confiança.

Exemplos

Este exemplo mostra como usar o My.Application.Log.WriteException método para registar exceções. Descomenta as Dim linhas e MsgBox para causar uma NullReferenceException exceção. Para mais informações, veja Como: Registar 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 dentro de uma aplicação cliente. Mudar My.Application.Log.WriteException para My.Log.WriteException aplicações Web.

Observações

O WriteException método escreve a informação contida numa exceção aos ouvintes do registo de eventos da aplicação.

Em aplicações cliente, o Log objeto está disponível através do My.Application.Log objeto. Em aplicações Web, o Log objeto está disponível através do My.Log objeto.

Para saber quais os ouvintes de log que recebem as WriteException mensagens do método, veja Walkthrough: Determinando Onde o My.Application.Log Escreve Informação. Podes mudar os ouvintes de registo por defeito. Para mais informações, consulte Trabalhar com Registos de Aplicação.

Para sobrecargas que não aceitam o id argumento, o identificador escrito no log é definido pela tabela seguinte.

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 seguinte lista exemplos de tarefas que envolvem o WriteException método.

Para Veja
Escreva informações de exceção nos ouvintes do registo de eventos da aplicação. Como registar exceções
Determina onde Log escreve a informação. Passo a passo: Determinando onde My.Application.Log grava informações

Disponibilidade por tipo de projeto

Tipo de Projeto Available
Aplicação do Windows Sim
Biblioteca de Classes Sim
Aplicativo de console Sim
Biblioteca de Controlo do Windows Sim
Biblioteca de controle da Web No
Serviço Windows Sim
Web site Sim

Ver também

Aplica-se a

WriteException(Exception, TraceEventType, String)

Escreve informações de exceção para os ouvintes de registo da aplicação.

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 registo.

severity
TraceEventType

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

additionalInfo
String

String para acrescentar à mensagem. Por defeito, esta é uma cadeia vazia.

Exceções

ArgumentNullException

ex é Nothing.

InvalidEnumArgumentException

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

SecurityException

Código com confiança parcial chama o método, mas escreve num ouvinte de registo de eventos que requer total confiança.

Exemplos

Este exemplo mostra como usar o My.Application.Log.WriteException método para registar exceções. Descomenta as Dim linhas e MsgBox para causar uma NullReferenceException exceção. Para mais informações, veja Como: Registar 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 dentro de uma aplicação cliente. Mudar My.Application.Log.WriteException para My.Log.WriteException aplicações Web.

Observações

O WriteException método escreve a informação contida numa exceção aos ouvintes do registo de eventos da aplicação.

Em aplicações cliente, o Log objeto está disponível através do My.Application.Log objeto. Em aplicações Web, o Log objeto está disponível através do My.Log objeto.

Para saber quais os ouvintes de log que recebem as WriteException mensagens do método, veja Walkthrough: Determinando Onde o My.Application.Log Escreve Informação. Podes mudar os ouvintes de registo por defeito. Para mais informações, consulte Trabalhar com Registos de Aplicação.

Para sobrecargas que não aceitam o id argumento, o identificador escrito no log é definido pela tabela seguinte.

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 seguinte lista exemplos de tarefas que envolvem o WriteException método.

Para Veja
Escreva informações de exceção nos ouvintes do registo de eventos da aplicação. Como registar exceções
Determina onde Log escreve a informação. Passo a passo: Determinando onde My.Application.Log grava informações

Disponibilidade por tipo de projeto

Tipo de Projeto Available
Aplicação do Windows Sim
Biblioteca de Classes Sim
Aplicativo de console Sim
Biblioteca de Controlo do Windows Sim
Biblioteca de controle da Web No
Serviço Windows Sim
Web site Sim

Ver também

Aplica-se a

WriteException(Exception, TraceEventType, String, Int32)

Escreve informações de exceção para os ouvintes de registo da aplicação.

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 registo.

severity
TraceEventType

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

additionalInfo
String

String para acrescentar à mensagem. Por defeito, esta é uma cadeia vazia.

id
Int32

Identificador de mensagem, normalmente usado para correlação. Por defeito, está relacionado com entryType conforme descrito na tabela na secção de Observações.

Exceções

ArgumentNullException

ex é Nothing.

InvalidEnumArgumentException

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

SecurityException

Código com confiança parcial chama o método, mas escreve num ouvinte de registo de eventos que requer total confiança.

Exemplos

Este exemplo mostra como usar o My.Application.Log.WriteException método para registar exceções. Descomenta as Dim linhas e MsgBox para causar uma NullReferenceException exceção. Para mais informações, veja Como: Registar 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 dentro de uma aplicação cliente. Mudar My.Application.Log.WriteException para My.Log.WriteException aplicações Web.

Observações

O WriteException método escreve a informação contida numa exceção aos ouvintes do registo de eventos da aplicação.

Em aplicações cliente, o Log objeto está disponível através do My.Application.Log objeto. Em aplicações Web, o Log objeto está disponível através do My.Log objeto.

Para saber quais os ouvintes de log que recebem as WriteException mensagens do método, veja Walkthrough: Determinando Onde o My.Application.Log Escreve Informação. Podes mudar os ouvintes de registo por defeito. Para mais informações, consulte Trabalhar com Registos de Aplicação.

Para sobrecargas que não aceitam o id argumento, o identificador escrito no log é definido pela tabela seguinte.

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 seguinte lista exemplos de tarefas que envolvem o WriteException método.

Para Veja
Escreva informações de exceção nos ouvintes do registo de eventos da aplicação. Como registar exceções
Determina onde Log escreve a informação. Passo a passo: Determinando onde My.Application.Log grava informações

Disponibilidade por tipo de projeto

Tipo de Projeto Available
Aplicação do Windows Sim
Biblioteca de Classes Sim
Aplicativo de console Sim
Biblioteca de Controlo do Windows Sim
Biblioteca de controle da Web No
Serviço Windows Sim
Web site Sim

Ver também

Aplica-se a