Exportar (0) Imprimir
Expandir todo

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

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

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

public static void WriteEntry (
	string source,
	string message,
	EventLogEntryType type,
	int eventID
)
public static void WriteEntry (
	String source, 
	String message, 
	EventLogEntryType type, 
	int eventID
)
public static function WriteEntry (
	source : String, 
	message : String, 
	type : EventLogEntryType, 
	eventID : int
)
No aplicable.

Parámetros

source

Origen mediante el que se registra la aplicación en el equipo especificado.

message

Cadena que se va a escribir en el registro de eventos.

type

Uno de los valores de EventLogEntryType.

eventID

Identificador específico de la aplicación para el evento.

Tipo de excepciónCondición

ArgumentException

El valor de source es una cadena vacía ("").

O bien

El valor de source es referencia null (Nothing en Visual Basic) (Nothing en Visual Basic).

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 un EventLogEntryType válido.

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 en el registro de eventos una entrada con un parámetro eventID definido por la aplicación mediante un origen ya registrado como un origen de eventos para el registro adecuado. 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 le muestran estas cadenas al usuario para ayudarle a determinar qué ha podido salir mal y sugerirle nuevas acciones.

Además del identificador de eventos, esta sobrecarga de WriteEntry permite 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.

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. De esta manera, el sistema operativo dispondrá de tiempo para actualizar la lista de orígenes de eventos registrados y sus configuraciones. 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 de 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.

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 el parámetro message contiene un carácter NULL, el mensaje en el registro de eventos se finaliza en el carácter NULL.

// Create the source, if it does not already exist.
if(!EventLog.SourceExists("MySource"))
{
   // An event log source should not be created and immediately used.
   // There is a latency time to enable the source, it should be created
   // prior to executing the application that uses the source.
   // Execute this sample a second time to use the new source.
   EventLog.CreateEventSource("MySource", "myNewLog");
   Console.WriteLine("Creating EventSource");
   Console.WriteLine("Exiting, execute the application a second time to use the source.");
   // The source is created.  Exit the application to allow it to be registered.
   return;
}

// Set the 'description' for the event.
string myMessage = "This is my event.";
EventLogEntryType myEventLogEntryType = EventLogEntryType.Warning;
int myApplicationEventId = 100;

// Write the entry in the event log.
Console.WriteLine("Writing to EventLog.. ");
EventLog.WriteEntry("MySource",myMessage,
   myEventLogEntryType, myApplicationEventId);

// Create the source, if it does not already exist.
if (!(EventLog.SourceExists("MySource"))) {
    EventLog.CreateEventSource("MySource", "myNewLog");
    Console.WriteLine("Creating EventSource");
}
// Set the 'description' for the event.
String myMessage = "This is my event.";
EventLogEntryType myEventLogEntryType = EventLogEntryType.Warning;
int myApplicationEventId = 100;

// Write the entry in the event log.
Console.WriteLine("Writing to EventLog.. ");
EventLog.WriteEntry("MySource", myMessage, myEventLogEntryType, 
    myApplicationEventId);

Windows 98, Windows 2000 Service Pack 4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft