WriteException (Método, My.Application.Log y My.Log)

Actualización: noviembre 2007

Escribe información de excepción en los agentes de escucha del registro de la aplicación.

' 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
  Obligatorio. Excepción que se va a registrar.

• severity
  Tipo de mensaje. De forma predeterminada, es Error.

• additionalInfo
  Cadena que se anexa al mensaje. De manera predeterminada, es una cadena vacía.

• id
  Identificador del mensaje que normalmente se utiliza para la correlación. De manera predeterminada, es relativo a entryType, tal como se describe en la tabla de la sección Comentarios.

Excepciones

Las condiciones siguientes provocarán una excepción:

• La excepción o el tipo de mensaje es Nothing (ArgumentNullException).

• El tipo de mensaje no se corresponde con ninguno de los valores de la enumeración TraceEventType (InvalidEnumArgumentException).

• Código con confianza parcial que llama al método, pero escribe en un agente de escucha del registro de eventos que requiere plena confianza (SecurityException).

Comentarios

El método WriteException escribe la información contenida en una excepción en los agentes de escucha del registro de eventos de la aplicación.

En las aplicaciones cliente, el objeto Log está disponible a través del objeto My.Application.Log. En las aplicaciones Web, el objeto Log está disponible a través del objeto My.Log.

Para saber qué agentes de escucha de registro reciben los mensajes del método WriteException, vea Tutorial: Determinar el lugar en el que My.Application.Log escribe la información. Puede cambiar los agentes de escucha del registro predeterminados. Para obtener más información, vea Trabajar con registros de aplicación en Visual Basic.

Para las sobrecargas que no toman el argumento id, en la tabla siguiente se define el identificador escrito en el registro.

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

Tareas

En la tabla siguiente se muestran ejemplos de tareas en las que interviene el método WriteException.

Para	Vea
Escribir información de excepción en los agentes de escucha del registro de eventos de la aplicación.	Cómo: Registrar excepciones en Visual Basic
Determinar dónde Log escribe información.	Tutorial: Determinar el lugar en el que My.Application.Log escribe la información

Ejemplo

En este ejemplo se muestra cómo utilizar el método My.Application.Log.WriteException para registrar excepciones. Quite los comentarios de las líneas Dim y MsgBox para producir una excepción NullReferenceException. Para obtener más información, vea Cómo: Registrar excepciones en 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

Este ejemplo de código sólo se puede ejecutar en una aplicación de cliente. Cambie My.Application.Log.WriteException a My.Log.WriteException para las aplicaciones Web.

Requisitos

Espacio de nombres:Microsoft.VisualBasic.Logging

Clase:Log

**Ensamblado:**Visual Basic Runtime Library (en Microsoft.VisualBasic.dll)

Disponibilidad por tipo de proyecto

Tipo de proyecto	Disponible
Aplicación para Windows	Sí
Biblioteca de clases	Sí
Aplicación de consola	Sí
Biblioteca de controles de Windows	Sí
Biblioteca de controles Web	No
Servicio de Windows	Sí
Sitio Web	Sí

Permisos

El permiso siguiente puede ser necesario:

Permiso	Descripción
FileIOPermission	Controla la capacidad de tener acceso a archivos y carpetas. Enumeración asociada: Unrestricted.

Para obtener más información, vea Seguridad de acceso a código y Solicitar permisos.

Vea también

Tareas

Cómo: Registrar excepciones en Visual Basic

Tutorial: Determinar el lugar en el que My.Application.Log escribe la información

Conceptos

Trabajar con registros de aplicación en Visual Basic

Referencia

My.Application.Log (Objeto)

My.Log (Objeto)

System.Exception

System.Diagnostics.TraceEventType

Log.WriteException