Log.WriteException Método

Definición

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

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

Sobrecargas

Nombre Description
WriteException(Exception)

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

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

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

WriteException(Exception)

Escribe 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

Required. Excepción al registro.

Excepciones

ArgumentNullException

ex es Nothing.

SecurityException

El código con confianza parcial llama al método , pero escribe en un agente de escucha de 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 Dim líneas y MsgBox para provocar una NullReferenceException excepción. Para obtener más información, vea Cómo: Registrar excepciones.

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 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 a 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, consulte 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
Determine 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 Yes
Biblioteca de clases Yes
Aplicación de consola Yes
Biblioteca de controles de Windows Yes
Biblioteca de controles web No
Servicio de Windows Yes
Sitio web Yes

Consulte también

Se aplica a

WriteException(Exception, TraceEventType, String)

Escribe 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

Required. Excepción al registro.

severity
TraceEventType

El tipo de mensaje. De forma predeterminada, Error.

additionalInfo
String

Cadena que se va a anexar al mensaje. De forma predeterminada, se trata de una cadena vacía.

Excepciones

ArgumentNullException

ex es Nothing.

InvalidEnumArgumentException

El tipo de mensaje no es uno de los TraceEventType valores de enumeración.

SecurityException

El código con confianza parcial llama al método , pero escribe en un agente de escucha de 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 Dim líneas y MsgBox para provocar una NullReferenceException excepción. Para obtener más información, vea Cómo: Registrar excepciones.

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 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 a 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, consulte 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
Determine 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 Yes
Biblioteca de clases Yes
Aplicación de consola Yes
Biblioteca de controles de Windows Yes
Biblioteca de controles web No
Servicio de Windows Yes
Sitio web Yes

Consulte también

Se aplica a

WriteException(Exception, TraceEventType, String, Int32)

Escribe 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

Required. Excepción al registro.

severity
TraceEventType

El tipo de mensaje. De forma predeterminada, Error.

additionalInfo
String

Cadena que se va a anexar al mensaje. De forma predeterminada, se trata de una cadena vacía.

id
Int32

Identificador de mensaje, que normalmente se usa 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 es uno de los TraceEventType valores de enumeración.

SecurityException

El código con confianza parcial llama al método , pero escribe en un agente de escucha de 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 Dim líneas y MsgBox para provocar una NullReferenceException excepción. Para obtener más información, vea Cómo: Registrar excepciones.

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 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 a 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, consulte 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
Determine 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 Yes
Biblioteca de clases Yes
Aplicación de consola Yes
Biblioteca de controles de Windows Yes
Biblioteca de controles web No
Servicio de Windows Yes
Sitio web Yes

Consulte también

Se aplica a