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

Actualización: noviembre 2007

Escribe un mensaje a los agentes de escucha del registro de la aplicación.

' Usage
My.Application.Log.WriteEntry(message)
My.Application.Log.WriteEntry(message ,severity)
My.Application.Log.WriteEntry(message ,severity ,id)
' Web usage
My.Log.WriteEntry(message)
My.Log.WriteEntry(message ,severity)
My.Log.WriteEntry(message ,severity ,id)
' Declaration
Public Sub WriteEntry( _
   ByVal message As String _
)
' -or-
Public Sub WriteEntry( _
   ByVal message As String, _
   ByVal severity As System.Diagnostics.TraceEventType _
)
' -or-
Public Sub WriteEntry( _
   ByVal message As String, _
   ByVal severity As System.Diagnostics.TraceEventType, _
   ByVal id As Integer _
)

Parámetros

• message
  Obligatorio. Mensaje que se va a registrar. Si message es igual a Nothing, se utiliza una cadena vacía.

• severity
  Tipo de mensaje. De forma predeterminada, TraceEventType.Information.

• id
  Identificador del mensaje, normalmente utilizado para la correlación. De manera predeterminada, está relacionado con entryType, como se describe en la tabla.

Excepciones

Las siguientes condiciones provocan 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).

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

Comentarios

El método WriteEntry escribe un mensaje a los agentes de escucha del registro de eventos de la aplicación.

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

Para conocer qué agentes de escucha de registro reciben los mensajes del método WriteEntry, 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 sobrecargas que no toman el argumento id, la tabla siguiente define el valor id que se escribe en el registro.

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

Tareas

La tabla siguiente muestra una lista de ejemplos de tareas en las que está implicado el método WriteEntry.

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

Ejemplo

Este ejemplo muestra cómo utilizar el método My.Application.Log.WriteEntry para registrar información de traza. Para obtener más información, vea Cómo: Escribir mensajes de registro.

Public Sub TracingTest(ByVal fileName As String)
    My.Application.Log.WriteEntry( _
        "Entering TracingTest with argument " & _
        fileName & ".")
    ' Code to trace goes here.
    My.Application.Log.WriteEntry( _
        "Exiting TracingTest with argument " & _
        fileName & ".")
End Sub

Este ejemplo de código sólo se puede ejecutar en una aplicación cliente. Cambie My.Application.Log.WriteEntry a My.Log.WriteEntry para 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: Escribir mensajes de registro

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.Diagnostics.TraceEventType

Log.WriteEntry