Log.WriteException Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> unitPublic Sub WriteException (ex As Exception)Parámetros
- ex
- Exception
Obligatorio. Excepción que se va a registrar.
Excepciones
ex es Nothing.
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
- Exception
- TraceEventType
- Objetos (Visual Basic)
- Trabajar con registros de aplicaciones en Visual Basic
- Cómo: Registrar excepciones en Visual Basic
- Tutorial: Determinar el lugar en el que My.Application.Log escribe la informació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 -> unitPublic 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
ex es Nothing.
El tipo de mensaje no se corresponde con ninguno de los valores de la enumeración TraceEventType.
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
- Exception
- TraceEventType
- Objetos (Visual Basic)
- Trabajar con registros de aplicaciones en Visual Basic
- Cómo: Registrar excepciones en Visual Basic
- Tutorial: Determinar el lugar en el que My.Application.Log escribe la informació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 -> unitPublic 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
ex es Nothing.
El tipo de mensaje no se corresponde con ninguno de los valores de la enumeración TraceEventType.
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
- Exception
- TraceEventType
- Objetos (Visual Basic)
- Trabajar con registros de aplicaciones en Visual Basic
- Cómo: Registrar excepciones en Visual Basic
- Tutorial: Determinar el lugar en el que My.Application.Log escribe la información
Se aplica a
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de