Log.WriteException Método

  • Referencia

Definición

Espacio de nombres:
Microsoft.VisualBasic.Logging
Ensamblado:
Microsoft.VisualBasic.dll
Ensamblado:
Microsoft.VisualBasic.Forms.dll

Escribe la información de excepciones en los agentes de escucha de registro de la aplicación

Sobrecargas

WriteException(Exception)

Escribe la información de excepciones en los agentes de escucha de registro de la aplicación
WriteException(Exception, TraceEventType, String)

Escribe la información de excepciones en los agentes de escucha de registro de la aplicación
WriteException(Exception, TraceEventType, String, Int32)

Escribe la información de excepciones en los agentes de escucha de registro de la aplicación

WriteException(Exception)

Escribe la información de excepciones en los agentes de escucha de registro de la aplicación

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

Obligatorio. Excepción que se va a registrar.

Excepciones

ArgumentNullException

ex es Nothing.

SecurityException

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.

Ejemplos

En este ejemplo se muestra cómo usar el My.Application.Log.WriteException método para registrar excepciones. Quite la marca de comentario de las líneas Dim y MsgBox para generar una excepción NullReferenceException. Para obtener más información, vea Cómo: Registrar excepciones.

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 solo se puede ejecutar dentro de una aplicación cliente. Cambie My.Application.Log.WriteException a My.Log.WriteException para aplicaciones web.

Comentarios

El WriteException método 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 Log objeto está disponible a través del My.Application.Log objeto . En las aplicaciones web, el Log objeto está disponible a través del My.Log objeto .

Para obtener información sobre qué agentes de escucha de registro reciben los WriteException mensajes del método, consulte Tutorial: Determinar dónde escribe my.Application.Log información. Puede cambiar los agentes de escucha de registro predeterminados. Para obtener más información, vea Trabajar con registros de aplicaciones.

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

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

En la tabla siguiente se enumeran ejemplos de tareas que implican el WriteException método .

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

Disponibilidad por tipo de proyecto

Tipo de proyecto Disponible
Aplicación 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í

Consulte también

Se aplica a

WriteException(Exception, TraceEventType, String)

Escribe la información de excepciones en los agentes de escucha de registro de la aplicación

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

Obligatorio. Excepción que se va a registrar.

severity
TraceEventType

El tipo de mensaje. De manera predeterminada, es Error.

additionalInfo
String

Cadena que se va a anexar al mensaje. De manera predeterminada, es una cadena vacía.

Excepciones

ArgumentNullException

ex es Nothing.

InvalidEnumArgumentException

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

SecurityException

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.

Ejemplos

En este ejemplo se muestra cómo usar el My.Application.Log.WriteException método para registrar excepciones. Quite la marca de comentario de las líneas Dim y MsgBox para generar una excepción NullReferenceException. Para obtener más información, vea Cómo: Registrar excepciones.

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 solo se puede ejecutar dentro de una aplicación cliente. Cambie My.Application.Log.WriteException a My.Log.WriteException para aplicaciones web.

Comentarios

El WriteException método 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 Log objeto está disponible a través del My.Application.Log objeto . En las aplicaciones web, el Log objeto está disponible a través del My.Log objeto .

Para obtener información sobre qué agentes de escucha de registro reciben los WriteException mensajes del método, consulte Tutorial: Determinar dónde escribe my.Application.Log información. Puede cambiar los agentes de escucha de registro predeterminados. Para obtener más información, vea Trabajar con registros de aplicaciones.

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

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

En la tabla siguiente se enumeran ejemplos de tareas que implican el WriteException método .

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

Disponibilidad por tipo de proyecto

Tipo de proyecto Disponible
Aplicación 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í

Consulte también

Se aplica a

WriteException(Exception, TraceEventType, String, Int32)

Escribe la información de excepciones en los agentes de escucha de registro de la aplicación

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

Obligatorio. Excepción que se va a registrar.

severity
TraceEventType

El tipo de mensaje. De manera predeterminada, es Error.

additionalInfo
String

Cadena que se va a anexar al mensaje. De manera predeterminada, es una cadena vacía.

id
Int32

Identificador de mensaje, que se utiliza normalmente para la correlación. De forma predeterminada, relacionada con entryType como se describe en la tabla de la sección Comentarios.

Excepciones

ArgumentNullException

ex es Nothing.

InvalidEnumArgumentException

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

SecurityException

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.

Ejemplos

En este ejemplo se muestra cómo usar el My.Application.Log.WriteException método para registrar excepciones. Quite la marca de comentario de las líneas Dim y MsgBox para generar una excepción NullReferenceException. Para obtener más información, vea Cómo: Registrar excepciones.

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 solo se puede ejecutar dentro de una aplicación cliente. Cambie My.Application.Log.WriteException a para My.Log.WriteException aplicaciones web.

Comentarios

El WriteException método 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 Log objeto está disponible a través del My.Application.Log objeto . En las aplicaciones web, el Log objeto está disponible a través del My.Log objeto .

Para obtener información sobre qué agentes de escucha de registro reciben los WriteException mensajes del método, consulte Tutorial: Determinar dónde escribe my.Application.Log información. Puede cambiar los agentes de escucha de registro predeterminados. Para obtener más información, vea Trabajar con registros de aplicaciones.

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

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

En la tabla siguiente se enumeran ejemplos de tareas relacionadas con el WriteException método .

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

Disponibilidad por tipo de proyecto

Tipo de proyecto Disponible
Aplicación 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í

Consulte también

Se aplica a