Exportar (0) Imprimir
Expandir todo
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original

EventLog.WriteEntry (Método) (String, EventLogEntryType, Int32)

Escribe una entrada con el identificador de eventos definido por la aplicación y el texto de mensaje dado en el registro de eventos.

Espacio de nombres:  System.Diagnostics
Ensamblado:  System (en System.dll)

public void WriteEntry(
	string message,
	EventLogEntryType type,
	int eventID
)

Parámetros

message
Tipo: System.String
Cadena que se va a escribir en el registro de eventos.
type
Tipo: System.Diagnostics.EventLogEntryType
Uno de los valores de EventLogEntryType.
eventID
Tipo: System.Int32
Identificador específico de la aplicación para el evento.

ExcepciónCondición
ArgumentException

Aún no se ha establecido la propiedad Source de EventLog.

O bien

El método ha intentado registrar un origen de eventos nuevo, pero el nombre de equipo de MachineName no es válido.

‑O bien-

El origen ya está registrado para otro registro de eventos.

‑O bien-

eventID es menor que cero o mayor que UInt16.MaxValue.

‑O bien-

La cadena del mensaje tiene más de 32766 bytes.

‑O bien-

El nombre de origen produce una ruta de clave del Registro con una longitud superior a 254 caracteres.

InvalidOperationException

No se ha podido abrir la clave del Registro para el registro de eventos.

InvalidEnumArgumentException

type no es una clase EventLogEntryType válida.

Win32Exception

El sistema operativo ha notificado un error al escribir la entrada de evento en el registro. No hay ningún código de error de Windows disponible.

Utilice este método para escribir una entrada con un parámetro eventID definido por la aplicación en el registro de eventos. El parámetro eventID junto con el origen identifican de forma única un evento. Cada aplicación puede definir sus propios eventos numerados y las cadenas de descripción a las que se asignan. Los visores de eventos muestran estos valores para ayudar al usuario a determinar qué ha podido salir mal y sugerirle nuevas acciones.

NotaNota

La cadena message no puede contener %n, donde n es un valor entero (por ejemplo, %1), porque el visor de eventos lo trata como una cadena de inserción. Dado que una dirección de Protocolo de Internet, versión 6 (IPv6) puede contener esta secuencia de caracteres, no se puede registrar ningún mensaje de evento que contenga una dirección IPv6.

Además del identificador de eventos, se puede especificar un objeto EventLogEntryType para el evento que se está escribiendo en el registro de eventos. El parámetro type se indica mediante un icono y un texto en la columna Tipo del Visor de eventos de un registro. Este parámetro indica si el tipo de evento es un error, una advertencia, una información o una auditoría de aciertos o de errores.

Se debe establecer la propiedad Source en el componente EventLog para poder escribir entradas en el Registro. El origen de eventos deberá crearse y configurarse antes de escribir la primera entrada con él.

El nuevo origen de eventos deberá crearse durante la instalación de la aplicación. Esto permite al sistema operativo actualizar con tiempo la lista de orígenes de eventos registrados y su configuración. Si el sistema operativo aún no ha actualizado la lista de orígenes de eventos y se intenta escribir un evento con el nuevo origen, se producirá un error en la operación de escritura. Para configurar un nuevo origen, puede utilizarse EventLogInstaller o el método CreateEventSource. Es necesario contar con derechos administrativos en el equipo para crear un nuevo origen de eventos.

Si el origen especificado en la propiedad Source de esta instancia de EventLog no está registrado en el equipo donde el componente está escribiendo, WriteEntry llamará a CreateEventSource y registrará el origen.

NotaNota

Si no se especifica una propiedad MachineName para la instancia de EventLog antes de llamar a CreateEventSource o a WriteEntry, se supone que se trata del equipo local (".")

Si el sistema tuviera que registrar Source mediante una llamada a WriteEntry y la propiedad Log no estuviera establecida en la instancia de EventLog, se usará de manera predeterminada el registro de aplicaciones.

NotaNota

Los errores que se generan durante el proceso de registro de Source producen muchas de las excepciones enumeradas anteriormente.

El origen deberá configurarse para escribir o bien entradas adaptadas o bien cadenas directas. El método WriteEntry escribe la cadena especificada directamente en el registro de eventos, no utiliza un archivo de recursos de mensajes adaptado. Para escribir eventos mediante archivo de recursos de mensajes adaptado, deberá utilizarse el método WriteEvent.

Cuando una aplicación escriba entradas usando tanto identificadores de recursos como valores de cadena, deberán registrarse dos orígenes diferentes. Por ejemplo, puede configurarse un origen con archivos de recursos y usarlo en el método WriteEvent para escribir entradas en el registro de eventos mediante identificadores de recursos. A continuación, puede crearse otro origen sin archivos de recursos y usarlo en el método WriteEntry para escribir cadenas directamente en el registro de eventos.

NotaNota

Si se escribe una entrada en un equipo remoto, puede que el valor del mensaje (la cadena de texto) no sea el esperado si el equipo remoto no está ejecutando .NET Framework.

NotaNota

Si el parámetro message contiene un carácter NULL, el mensaje en el registro de eventos se finaliza en el carácter NULL.


// Create an EventLog instance and assign its source.
EventLog myLog = new EventLog();
myLog.Source = "ThirdSource";

// Write an informational entry to the event log.    
Console.WriteLine("Write from third source ");
myLog.WriteEntry("Writing warning to event log.",
                  EventLogEntryType.Warning, myEventID, myCategory);


.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

date

Historial

Motivo

Mayo de 2010

Agregada nota sobre el uso de %n en el parámetro message.

Corrección de errores de contenido.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft