Compartilhar via


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:

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