WriteException método (My.aplicativo.log and My.log)

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

' Usage
My.Application.Log.WriteException(ex)
My.Application.Log.WriteException(ex ,severity ,additionalInfo)
My.Application.Log.WriteException(ex ,severity ,additionalInfo ,id)
' Web usage
My.Log.WriteException(ex)
My.Log.WriteException(ex ,severity ,additionalInfo)
My.Log.WriteException(ex ,severity ,additionalInfo ,id)
' Declaration
Public Sub WriteException( _
   ByVal ex As System.Exception _
)
' -or-
Public Sub WriteException( _
   ByVal ex As System.Exception, _
   ByVal severity As System.Diagnostics.TraceEventType, _
   ByVal additionalInfo As String _
)
' -or-
Public Sub WriteException( _
   ByVal ex As System.Exception, _
   ByVal severity As System.Diagnostics.TraceEventType, _
   ByVal additionalInfo As String, _
   ByVal id As Integer _
)

Parâmetros

• ex
  Obrigatório.Exceção ao log.

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

• additionalInfo
  Seqüência de caracteres para acrescentar a mensagem.Por padrão, essa é uma seqüência de caracteres vazia.

• id
  Identificador de mensagem, normalmente usado para correlação.Por padrão, relacionado a entryType sistema autônomo descritos na tabela na seção comentários.

Exceções

As condições a seguir causará uma exceção:

• O tipo de exceção ou mensagem é Nothing (ArgumentNullException).

• O tipo de mensagem não é um dos valores de enumeração TraceEventType (InvalidEnumArgumentException).

• Código com confiabilidade parcial chama o método, mas escreve em um ouvinte de evento que exige confiabilidade total (SecurityException).

Comentários

The WriteException método grava as informações contidas em uma exceção para o aplicativo evento ouvintes de log.

Em aplicativos do cliente, o objeto Log está disponível através do objeto My.Application.Log.Em aplicativos do Web, o objeto Log está disponível através do objeto My.Log.

Para saber quais ouvintes de log recebem as mensagens do método WriteException, consulte Demonstra Passo a passo: Determinar onde My.Aplicativo.Log Writes informações.Você pode alterar ouvintes de log padrões.Para obter mais informações, consulte Trabalhando com logs de aplicativos em Visual Basic.

Para sobrecargas que não têm o id argumento, o identificador gravado no log é definido na tabela a seguir.

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

Tarefas

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

Para	Consulte
Grave informações de exceção para ouvintes de log de eventos do aplicativo.	Como: Log Exceptions in Visual Basic
Determinar onde Log grava as informações.	Demonstra Passo a passo: Determinar onde My.Aplicativo.Log Writes informações

Exemplo

Este exemplo mostra como usar o My.Application.Log.WriteException método para log exceções. Tire os comentários das linhas Dim e MsgBox para causar uma exceção NullReferenceException.Para obter mais informações, consulte Como: Log Exceptions in Visual Basic.

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

Esta exemplo de código pode executar somente em um aplicativo cliente.Altere My.Application.Log.WriteException para My.Log.WriteException para aplicativos da Web.

Requisitos

Namespace:Microsoft.VisualBasic.Logging

Classe:Log

Assembly: Visual Basic Runtime Library (em Microsoft.VisualBasic.dll)

Disponibilidade por Tipo de Projeto

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

Permissões

A permissão a seguir pode ser necessária:

Permissão	Descrição
FileIOPermission	Controla a habilidade de acesso a arquivos e pastas.Enumeração associada: Unrestricted.

Para obter mais informações, consulte Segurança de Acesso de código e Solicitando permissões.

Consulte também

Tarefas

Como: Log Exceptions in Visual Basic

Demonstra Passo a passo: Determinar onde My.Aplicativo.Log Writes informações

Conceitos

Trabalhando com logs de aplicativos em Visual Basic

Referência

Objeto My.Application.Log

Objeto My.Log

System.Exception

System.Diagnostics.TraceEventType

Log.WriteException