EventLog.WriteEntry Método

Definición

Escribe una entrada en el registro de eventos.

Sobrecargas

WriteEntry(String, String, EventLogEntryType, Int32, Int16, Byte[])

Escribe en el registro de eventos una entrada con el texto de mensaje dado, el identificador de eventos definido por la aplicación y la categoría definida por la aplicación (mediante el origen de eventos registrado especificado) y anexa datos binarios al mensaje.

WriteEntry(String, String, EventLogEntryType, Int32, Int16)

Escribe en el registro de eventos una entrada con el texto de mensaje dado, el identificador de eventos definido por la aplicación y la categoría definida por la aplicación mediante el origen de eventos registrado específico. El Visor de eventos puede usar el parámetro category para filtrar los eventos del registro.

WriteEntry(String, EventLogEntryType, Int32, Int16, Byte[])

Escribe en el registro de eventos una entrada con el texto de mensaje dado, el identificador de eventos definido por la aplicación y la categoría definida por la aplicación y anexa datos binarios al mensaje.

WriteEntry(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 que se especifique.

WriteEntry(String, EventLogEntryType, Int32, Int16)

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

WriteEntry(String, EventLogEntryType)

Escribe en el registro de eventos una entrada de error, advertencia, información, auditoría correcta o auditoría incorrecta con el texto de mensaje dado.

WriteEntry(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.

WriteEntry(String, String)

Escribe una entrada de tipo de información con un texto de mensaje determinado en el registro de eventos utilizando el origen de eventos registrado que se haya especificado.

WriteEntry(String)

Escribe una entrada de tipo de información, con un texto de mensaje determinado, en el registro de eventos.

WriteEntry(String, String, EventLogEntryType)

Escribe en el registro de eventos una entrada de error, advertencia, información, auditoría correcta o auditoría incorrecta con el texto de mensaje dado mediante el origen de eventos registrado especificado.

WriteEntry(String, String, EventLogEntryType, Int32, Int16, Byte[])

Escribe en el registro de eventos una entrada con el texto de mensaje dado, el identificador de eventos definido por la aplicación y la categoría definida por la aplicación (mediante el origen de eventos registrado especificado) y anexa datos binarios al mensaje.

public:
 static void WriteEntry(System::String ^ source, System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID, short category, cli::array <System::Byte> ^ rawData);
public static void WriteEntry (string source, string message, System.Diagnostics.EventLogEntryType type, int eventID, short category, byte[] rawData);
static member WriteEntry : string * string * System.Diagnostics.EventLogEntryType * int * int16 * byte[] -> unit
Public Shared Sub WriteEntry (source As String, message As String, type As EventLogEntryType, eventID As Integer, category As Short, rawData As Byte())

Parámetros

source
String

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

message
String

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

type
EventLogEntryType

Uno de los valores de EventLogEntryType.

eventID
Int32

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

category
Int16

Subcategoría específica de la aplicación asociada al mensaje.

rawData
Byte[]

Matriz de bytes que incluye los datos binarios asociados a la entrada.

Excepciones

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

o bien

El valor source es null.

o bien

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

o bien

La cadena de mensaje es más de 31.839 bytes (32.766 bytes en los sistemas operativos Windows anterior a Windows Vista).

o bien

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

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

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.

Ejemplos

//Create a byte array for binary data to associate with the entry.
array<Byte>^myByte = gcnew array<Byte>(10);
//Populate the byte array with simulated data.
for ( int i = 0; i < 10; i++ )
{
   myByte[ i ] = (Byte)(i % 2);
}
//Write an entry to the event log that includes associated binary data.
Console::WriteLine( "Write from second source " );
EventLog::WriteEntry( "SecondSource", "Writing warning to event log.",
   EventLogEntryType::Error, myEventID, myCategory, myByte );
//Create a byte array for binary data to associate with the entry.
byte[] myByte = new byte[10];
//Populate the byte array with simulated data.
for (int i = 0; i < 10; i++)
{
    myByte[i] = (byte)(i % 2);
}
// Write an entry to the event log that includes associated binary data.
Console.WriteLine("Write from second source ");
EventLog.WriteEntry("SecondSource", "Writing warning to event log.",
                     EventLogEntryType.Error, myEventID, myCategory, myByte);
' Create a byte array for binary data to associate with the entry.
Dim myByte(9) As Byte
Dim i As Integer
' Populate the byte array with simulated data.
For i = 0 To 9
    myByte(i) = CByte(i Mod 2)
Next i
' Write an entry to the event log that includes associated binary data.
Console.WriteLine("Write from second source ")
EventLog.WriteEntry("SecondSource", "Writing warning to event log.", _
                     EventLogEntryType.Error, myEventID, myCategory, myByte)

Comentarios

Use este método para escribir datos específicos de eventos definidos por la aplicación en el registro de eventos, con un origen ya registrado como origen de eventos para el registro adecuado. El Visor de eventos no interpreta estos datos; muestra los datos sin procesar solo en un formato hexadecimal y de texto combinado. Usar datos específicos de eventos con moderación; incluirlo solo si está seguro de que será útil. También puede usar datos específicos del evento para almacenar información que la aplicación puede procesar independientemente del Visor de eventos. Por ejemplo, podría escribir un visor específicamente para los eventos o escribir un programa que examine el archivo de registro y cree informes que incluyan información de los datos específicos del evento.

Además de los datos binarios, puede especificar una categoría definida por la aplicación y un identificador de evento definido por la aplicación. El Visor de eventos usa la categoría para filtrar los eventos escritos por un origen de eventos. El Visor de eventos puede mostrar la categoría como un valor numérico, o bien puede usar la categoría como identificador de recurso para mostrar una cadena de categoría localizada.

Nota

El category parámetro debe ser un valor positivo. Los valores de categoría negativos aparecen como un número positivo complementario en el Visor de eventos. Por ejemplo, un -10 aparecerá como 65 526, un -1 como 65 535.

Para mostrar cadenas de categoría localizadas en el Visor de eventos, debe usar un origen de eventos configurado con un archivo de recursos de categoría y establecer en category un identificador de recurso en el archivo de recursos de categoría. Si el origen del evento no tiene un archivo de recursos de categoría configurado o el especificado category no indexa una cadena en el archivo de recursos de categoría, el Visor de eventos muestra el valor numérico de la categoría para esa entrada. Configure el archivo de recursos de categoría, junto con el número de cadenas de categoría en el archivo de recursos, mediante o EventLogInstaller la EventSourceCreationData clase .

Los identificadores de evento, junto con el origen del evento, 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 de cadena para ayudar al usuario a comprender qué ha ido mal y sugerir las acciones que se deben realizar.

Por último, puede especificar un EventLogEntryType para el evento que se va a escribir en el registro de eventos. type Se indica mediante un icono y texto en la columna Tipo de la Visor de eventos de un registro. Este parámetro indica si el tipo de evento es error, advertencia, información, auditoría correcta o auditoría de error.

Debe crear y configurar el origen del evento antes de escribir la primera entrada con el origen. Cree el nuevo origen de eventos durante la instalación de la aplicación. Esto permite que el sistema operativo actualice su lista de orígenes de eventos registrados y su configuración. Si el sistema operativo no ha actualizado su lista de orígenes de eventos e intenta escribir un evento con el nuevo origen, se producirá un error en la operación de escritura. Puede configurar un nuevo origen mediante EventLogInstaller, o mediante el CreateEventSource método . Debe tener derechos administrativos en el equipo para crear un nuevo origen de eventos.

El origen debe configurarse para escribir entradas localizadas o para escribir cadenas directas. El WriteEntry método escribe la cadena especificada directamente en el registro de eventos; no usa un archivo de recursos de mensaje localizable. Use el WriteEvent método para escribir eventos mediante un archivo de recursos de mensaje localizado.

Si la aplicación escribe entradas mediante identificadores de recursos y valores de cadena, debe registrar dos orígenes independientes. Por ejemplo, configure un origen con archivos de recursos y, a continuación, use ese origen en el WriteEvent método para escribir entradas mediante identificadores de recursos en el registro de eventos. A continuación, cree un origen diferente sin archivos de recursos y use ese origen en el WriteEntry método para escribir cadenas directamente en el registro de eventos mediante ese origen.

Nota

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

La message cadena 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. Como un protocolo de Internet, la dirección de la versión 6 (IPv6) puede contener esta secuencia de caracteres, no puede registrar un mensaje de evento que contenga una dirección IPv6.

Consulte también

Se aplica a

WriteEntry(String, String, EventLogEntryType, Int32, Int16)

Escribe en el registro de eventos una entrada con el texto de mensaje dado, el identificador de eventos definido por la aplicación y la categoría definida por la aplicación mediante el origen de eventos registrado específico. El Visor de eventos puede usar el parámetro category para filtrar los eventos del registro.

public:
 static void WriteEntry(System::String ^ source, System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID, short category);
public static void WriteEntry (string source, string message, System.Diagnostics.EventLogEntryType type, int eventID, short category);
static member WriteEntry : string * string * System.Diagnostics.EventLogEntryType * int * int16 -> unit
Public Shared Sub WriteEntry (source As String, message As String, type As EventLogEntryType, eventID As Integer, category As Short)

Parámetros

source
String

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

message
String

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

type
EventLogEntryType

Uno de los valores de EventLogEntryType.

eventID
Int32

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

category
Int16

Subcategoría específica de la aplicación asociada al mensaje.

Excepciones

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

o bien

El valor source es null.

o bien

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

o bien

La cadena de mensaje es más de 31.839 bytes (32.766 bytes en los sistemas operativos Windows anterior a Windows Vista).

o bien

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

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

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.

Ejemplos

int myEventID = 20;
short myCategory = 10;

// Write an informational entry to the event log.
Console::WriteLine( "Write from first source " );
EventLog::WriteEntry( "FirstSource", "Writing warning to event log.",
   EventLogEntryType::Information, myEventID, myCategory );
int myEventID = 20;
short myCategory = 10;
// Write an informational entry to the event log.
Console.WriteLine("Write from first source ");
EventLog.WriteEntry("FirstSource", "Writing warning to event log.",
                     EventLogEntryType.Information, myEventID, myCategory);
Dim myEventID As Integer = 10
Dim myCategory As Short = 20
' Write an informational entry to the event log.
Console.WriteLine("Write from first source ")
EventLog.WriteEntry("FirstSource", "Writing warning to event log.", _
                           EventLogEntryType.Information, myEventID, myCategory)

Comentarios

Use este método para escribir una entrada con una aplicación definida category en el registro de eventos mediante un origen que ya está registrado como origen de eventos para el registro adecuado. El Visor de eventos usa la categoría para filtrar los eventos escritos por un origen de eventos. El Visor de eventos puede mostrar la categoría como un valor numérico, o bien puede usar la categoría como identificador de recurso para mostrar una cadena de categoría localizada.

Nota

El category parámetro debe ser un valor positivo. Los valores de categoría negativos aparecen como un número positivo complementario en el Visor de eventos. Por ejemplo, un -10 aparece como 65 526, un -1 como 65 535.

Para mostrar cadenas de categoría localizadas en el Visor de eventos, debe usar un origen de eventos configurado con un archivo de recursos de categoría y establecer en category un identificador de recurso en el archivo de recursos de categoría. Si el origen del evento no tiene un archivo de recursos de categoría configurado o el especificado category no indexa una cadena en el archivo de recursos de categoría, el Visor de eventos muestra el valor numérico de la categoría para esa entrada. Configure el archivo de recursos de categoría, junto con el número de cadenas de categoría en el archivo de recursos, mediante o EventLogInstaller la EventSourceCreationData clase .

Además de la categoría, puede especificar un identificador de evento para el evento que se escribe en el registro de eventos. Los identificadores de evento, junto con el origen del evento, 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 de cadena para ayudar al usuario a comprender lo que salió mal y sugerir qué acciones realizar.

Por último, puede especificar un EventLogEntryType para el evento que se va a escribir en el registro de eventos. type Se indica mediante un icono y texto en la columna Tipo de la Visor de eventos de un registro. Este parámetro indica si el tipo de evento es error, advertencia, información, auditoría correcta o auditoría de error.

Debe crear y configurar el origen del evento antes de escribir la primera entrada con el origen. Cree el nuevo origen de eventos durante la instalación de la aplicación. Esto permite que el sistema operativo actualice su lista de orígenes de eventos registrados y su configuración. Si el sistema operativo no ha actualizado su lista de orígenes de eventos e intenta escribir un evento con el nuevo origen, se producirá un error en la operación de escritura. Puede configurar un nuevo origen mediante o EventLogInstallermediante el CreateEventSource método . Debe tener derechos administrativos en el equipo para crear un nuevo origen de eventos.

El origen debe configurarse para escribir entradas localizadas o para escribir cadenas directas. El WriteEntry método escribe la cadena especificada directamente en el registro de eventos; no usa un archivo de recursos de mensaje localizable. Use el WriteEvent método para escribir eventos mediante un archivo de recursos de mensaje localizado.

Si la aplicación escribe entradas con identificadores de recursos y valores de cadena, debe registrar dos orígenes independientes. Por ejemplo, configure un origen con archivos de recursos y después use ese origen en el WriteEvent método para escribir entradas mediante identificadores de recursos en el registro de eventos. A continuación, cree otro origen sin archivos de recursos y use ese origen en el WriteEntry método para escribir cadenas directamente en el registro de eventos mediante ese origen.

Nota

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

La message cadena 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. Como un protocolo de Internet, la dirección de la versión 6 (IPv6) puede contener esta secuencia de caracteres, no se puede registrar un mensaje de evento que contenga una dirección IPv6.

Consulte también

Se aplica a

WriteEntry(String, EventLogEntryType, Int32, Int16, Byte[])

Escribe en el registro de eventos una entrada con el texto de mensaje dado, el identificador de eventos definido por la aplicación y la categoría definida por la aplicación y anexa datos binarios al mensaje.

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID, short category, cli::array <System::Byte> ^ rawData);
public void WriteEntry (string message, System.Diagnostics.EventLogEntryType type, int eventID, short category, byte[] rawData);
member this.WriteEntry : string * System.Diagnostics.EventLogEntryType * int * int16 * byte[] -> unit
Public Sub WriteEntry (message As String, type As EventLogEntryType, eventID As Integer, category As Short, rawData As Byte())

Parámetros

message
String

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

type
EventLogEntryType

Uno de los valores de EventLogEntryType.

eventID
Int32

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

category
Int16

Subcategoría específica de la aplicación asociada al mensaje.

rawData
Byte[]

Matriz de bytes que incluye los datos binarios asociados a la entrada.

Excepciones

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 de mensaje es más de 31.839 bytes (32.766 bytes en los sistemas operativos Windows anterior a Windows Vista).

o bien

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

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

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.

Ejemplos

// Create the source, if it does not already exist.
String^ myLogName = "myNewLog";
if (  !EventLog::SourceExists( "MySource" ) )
{
   EventLog::CreateEventSource( "MySource", myLogName );
   Console::WriteLine( "Creating EventSource" );
}
else
   myLogName = EventLog::LogNameFromSourceName( "MySource", "." );

// Create an EventLog and assign source.
EventLog^ myEventLog = gcnew EventLog;
myEventLog->Source = "MySource";
myEventLog->Log = myLogName;

// Set the 'description' for the event.
String^ myMessage = "This is my event.";
EventLogEntryType myEventLogEntryType = EventLogEntryType::Warning;
int myApplicatinEventId = 1100;
short myApplicatinCategoryId = 1;

// Set the 'data' for the event.
array<Byte>^ myRawData = gcnew array<Byte>(4);
for ( int i = 0; i < 4; i++ )
{
   myRawData[ i ] = 1;
}
Console::WriteLine( "Writing to EventLog.. " );
myEventLog->WriteEntry( myMessage, myEventLogEntryType, myApplicatinEventId, myApplicatinCategoryId, myRawData );
// Create the source, if it does not already exist.
string myLogName = "myNewLog";
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", myLogName);
   Console.WriteLine("Created EventSource");
   Console.WriteLine("Exiting, execute the application a second time to use the source.");
   return;
}
else
   {
       myLogName = EventLog.LogNameFromSourceName("MySource",".");
   }
   // Create an EventLog and assign source.
   EventLog myEventLog = new EventLog();
myEventLog.Source = "MySource";
myEventLog.Log = myLogName;

// Set the 'description' for the event.
string myMessage = "This is my event.";
EventLogEntryType myEventLogEntryType = EventLogEntryType.Warning;
int myApplicatinEventId = 1100;
short myApplicatinCategoryId = 1;

// Set the 'data' for the event.
byte[] myRawData = new byte[4];
for(int i=0;i<4;i++)
{
   myRawData[i]=1;
}
// Write the entry in the event log.
Console.WriteLine("Writing to EventLog.. ");
myEventLog.WriteEntry(myMessage,myEventLogEntryType,
   myApplicatinEventId, myApplicatinCategoryId, myRawData);
' Create the source, if it does not already exist.
dim myLogName as string = "myNewLog"
If Not EventLog.SourceExists("MySource") Then
   EventLog.CreateEventSource("MySource", myLogName)
   Console.WriteLine("Creating EventSource")
else
   myLogName = EventLog.LogNameFromSourceName("MySource",".")
End If

' Create an EventLog and assign source.
Dim myEventLog As New EventLog()
myEventLog.Source = "MySource"
myEventLog.Log = myLogName

' Set the 'description' for the event.
Dim myMessage As String = "This is my event."
Dim myEventLogEntryType As EventLogEntryType = EventLogEntryType.Warning
Dim myApplicatinEventId As Integer = 1100
Dim myApplicatinCategoryId As Short = 1

' Set the 'data' for the event.
Dim myRawData(3) As Byte
Dim i As Integer
For i = 0 To 3
   myRawData(i) = 1
Next i
' Write the entry in the event log.
Console.WriteLine("Writing to EventLog.. ")
myEventLog.WriteEntry(myMessage, myEventLogEntryType, myApplicatinEventId, _
                     myApplicatinCategoryId, myRawData)

Comentarios

Use esta sobrecarga para escribir datos específicos de eventos definidos por la aplicación en el registro de eventos. El Visor de eventos no interpreta estos datos; solo muestra los datos sin procesar en un formato hexadecimal y de texto combinado. Use datos específicos de eventos con moderación, incluido solo si está seguro de que será útil para alguien que depura el problema. También puede usar datos específicos del evento para almacenar información que la aplicación puede procesar independientemente del Visor de eventos. Por ejemplo, podría escribir un visor específicamente para los eventos o escribir un programa que examine el archivo de registro y cree informes que incluyan información de los datos específicos del evento.

Además de los datos binarios, puede especificar una categoría definida por la aplicación y un identificador de evento definido por la aplicación. El Visor de eventos usa la categoría para filtrar los eventos escritos por un origen de eventos. El Visor de eventos puede mostrar la categoría como un valor numérico, o bien puede usar la categoría como identificador de recurso para mostrar una cadena de categoría localizada.

Nota

La message cadena 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. Como un protocolo de Internet, la dirección de la versión 6 (IPv6) puede contener esta secuencia de caracteres, no se puede registrar un mensaje de evento que contenga una dirección IPv6.

Nota

El category parámetro debe ser un valor positivo. Los valores de categoría negativos aparecen como un número positivo complementario en el Visor de eventos. Por ejemplo, un -10 aparece como 65 526, un -1 como 65 535.

Para mostrar cadenas de categoría localizadas en el Visor de eventos, debe usar un origen de eventos configurado con un archivo de recursos de categoría y establecer en category un identificador de recurso en el archivo de recursos de categoría. Si el origen del evento no tiene un archivo de recursos de categoría configurado o el especificado category no indexa una cadena en el archivo de recursos de categoría, el Visor de eventos muestra el valor numérico de la categoría para esa entrada. Configure el archivo de recursos de categoría, junto con el número de cadenas de categoría en el archivo de recursos, mediante o EventLogInstaller la EventSourceCreationData clase .

Los identificadores de evento, junto con el origen del evento, 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 de cadena para ayudar al usuario a comprender lo que salió mal y sugerir qué acciones realizar.

Por último, puede especificar un EventLogEntryType para el evento que se va a escribir en el registro de eventos. type Se indica mediante un icono y texto en la columna Tipo de la Visor de eventos de un registro. Este parámetro indica si el tipo de evento es error, advertencia, información, auditoría correcta o auditoría de error.

Debe establecer la propiedad en EventLog el Source componente para poder escribir entradas en el registro. Debe crear y configurar el origen del evento antes de escribir la primera entrada con el origen.

Cree el nuevo origen de eventos durante la instalación de la aplicación. Esto permite que el sistema operativo actualice su lista de orígenes de eventos registrados y su configuración. Si el sistema operativo no ha actualizado su lista de orígenes de eventos e intenta escribir un evento con el nuevo origen, se producirá un error en la operación de escritura. Puede configurar un nuevo origen mediante o EventLogInstallermediante el CreateEventSource método . Debe tener derechos administrativos en el equipo para crear un nuevo origen de eventos.

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

Nota

Si no especifica un MachineName para la EventLog instancia antes de llamar a CreateEventSource o WriteEntry, se asume el equipo local (".").

Si el sistema necesita registrar mediante Source una llamada a WriteEntry y la propiedad no se ha establecido en EventLog la Log instancia, el registro tiene como valor predeterminado el registro de aplicación.

Nota

Muchas excepciones enumeradas anteriormente se generan mediante errores generados durante el proceso de registro de Source.

El origen debe configurarse para escribir entradas localizadas o para escribir cadenas directas. El WriteEntry método escribe la cadena especificada directamente en el registro de eventos; no usa un archivo de recursos de mensaje localizable. Use el WriteEvent método para escribir eventos mediante un archivo de recursos de mensaje localizado.

Si la aplicación escribe entradas con identificadores de recursos y valores de cadena, debe registrar dos orígenes independientes. Por ejemplo, configure un origen con archivos de recursos y después use ese origen en el WriteEvent método para escribir entradas mediante identificadores de recursos en el registro de eventos. A continuación, cree otro origen sin archivos de recursos y use ese origen en el WriteEntry método para escribir cadenas directamente en el registro de eventos mediante ese origen.

Nota

Si escribe una entrada en un equipo remoto, es posible que el valor del mensaje (la cadena de texto) no sea lo que espera si el equipo remoto no ejecuta .NET Framework.

Nota

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

Consulte también

Se aplica a

WriteEntry(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 que se especifique.

public:
 static void WriteEntry(System::String ^ source, System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID);
public static void WriteEntry (string source, string message, System.Diagnostics.EventLogEntryType type, int eventID);
static member WriteEntry : string * string * System.Diagnostics.EventLogEntryType * int -> unit
Public Shared Sub WriteEntry (source As String, message As String, type As EventLogEntryType, eventID As Integer)

Parámetros

source
String

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

message
String

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

type
EventLogEntryType

Uno de los valores de EventLogEntryType.

eventID
Int32

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

Excepciones

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

o bien

El valor source es null.

o bien

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

o bien

La cadena de mensaje es más de 31.839 bytes (32.766 bytes en los sistemas operativos Windows anterior a Windows Vista).

o bien

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

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

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.

Ejemplos

// 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 );
// 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 Not EventLog.SourceExists("MySource") Then
   EventLog.CreateEventSource("MySource", "myNewLog")
   Console.WriteLine("Creating EventSource")
End If

' Set the 'description' for the event.
Dim myMessage As String = "This is my event."
Dim myEventLogEntryType As EventLogEntryType = EventLogEntryType.Warning
Dim myApplicationEventId As Integer = 100

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

Comentarios

Use este método para escribir una entrada con una aplicación definida eventID en el registro de eventos mediante un origen ya registrado como origen de eventos para el registro adecuado. , eventIDjunto con el origen, identifica 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 presentan estas cadenas al usuario para ayudar al usuario a comprender lo que salió mal y sugerir qué acciones realizar.

Nota

La message cadena 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. Como un protocolo de Internet, la dirección de la versión 6 (IPv6) puede contener esta secuencia de caracteres, no se puede registrar un mensaje de evento que contenga una dirección IPv6.

Además del identificador de evento, esta sobrecarga de WriteEntry permite especificar un EventLogEntryType para el evento que se escribe en el registro de eventos. type Se indica mediante un icono y texto en la columna Tipo de la Visor de eventos de un registro. Este parámetro indica si el tipo de evento es error, advertencia, información, auditoría correcta o auditoría de error.

Debe crear y configurar el origen del evento antes de escribir la primera entrada con el origen. Cree el nuevo origen de eventos durante la instalación de la aplicación. Esto permite que el sistema operativo actualice su lista de orígenes de eventos registrados y su configuración. Si el sistema operativo no ha actualizado su lista de orígenes de eventos e intenta escribir un evento con el nuevo origen, se producirá un error en la operación de escritura. Puede configurar un nuevo origen mediante o EventLogInstallermediante el CreateEventSource método . Debe tener derechos administrativos en el equipo para crear un nuevo origen de eventos.

El origen debe configurarse para escribir entradas localizadas o para escribir cadenas directas. El WriteEntry método escribe la cadena especificada directamente en el registro de eventos; no usa un archivo de recursos de mensaje localizable. Use el WriteEvent método para escribir eventos mediante un archivo de recursos de mensaje localizado.

Si la aplicación escribe entradas con identificadores de recursos y valores de cadena, debe registrar dos orígenes independientes. Por ejemplo, configure un origen con archivos de recursos y después use ese origen en el WriteEvent método para escribir entradas mediante identificadores de recursos en el registro de eventos. A continuación, cree otro origen sin archivos de recursos y use ese origen en el WriteEntry método para escribir cadenas directamente en el registro de eventos mediante ese origen.

Nota

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

Consulte también

Se aplica a

WriteEntry(String, EventLogEntryType, Int32, Int16)

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

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID, short category);
public void WriteEntry (string message, System.Diagnostics.EventLogEntryType type, int eventID, short category);
member this.WriteEntry : string * System.Diagnostics.EventLogEntryType * int * int16 -> unit
Public Sub WriteEntry (message As String, type As EventLogEntryType, eventID As Integer, category As Short)

Parámetros

message
String

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

type
EventLogEntryType

Uno de los valores de EventLogEntryType.

eventID
Int32

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

category
Int16

Subcategoría específica de la aplicación asociada al mensaje.

Excepciones

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 de mensaje es más de 31.839 bytes (32.766 bytes en los sistemas operativos Windows anterior a Windows Vista).

o bien

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

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

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.

Ejemplos

// Create an EventLog instance and assign its source.
EventLog^ myLog = gcnew 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 );
// 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);
' Create an EventLog instance and assign its source.
Dim myLog As 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)

Comentarios

Use este método para escribir una entrada con una aplicación definida en category el registro de eventos. El Visor de eventos usa la categoría para filtrar los eventos escritos por un origen de eventos. El Visor de eventos puede mostrar la categoría como un valor numérico, o bien puede usar la categoría como identificador de recurso para mostrar una cadena de categoría localizada.

Nota

El category parámetro debe ser un valor positivo. Los valores de categoría negativos aparecen como un número positivo complementario en el Visor de eventos. Por ejemplo, un -10 aparece como 65 526, un -1 como 65 535.

Nota

La message cadena 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. Como un protocolo de Internet, la dirección de la versión 6 (IPv6) puede contener esta secuencia de caracteres, no se puede registrar un mensaje de evento que contenga una dirección IPv6.

Para mostrar cadenas de categoría localizadas en el Visor de eventos, debe usar un origen de eventos configurado con un archivo de recursos de categoría y establecer en category un identificador de recurso en el archivo de recursos de categoría. Si el origen del evento no tiene un archivo de recursos de categoría configurado o el especificado category no indexa una cadena en el archivo de recursos de categoría, el Visor de eventos muestra el valor numérico de la categoría para esa entrada. Configure el archivo de recursos de categoría, junto con el número de cadenas de categoría en el archivo de recursos, mediante o EventLogInstaller la EventSourceCreationData clase .

Además de la categoría, puede especificar un identificador de evento para el evento que se escribe en el registro de eventos. Los identificadores de evento, junto con el origen del evento, 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 de cadena para ayudar al usuario a comprender lo que salió mal y sugerir qué acciones realizar.

Por último, puede especificar un EventLogEntryType para el evento que se va a escribir en el registro de eventos. type Se indica mediante un icono y texto en la columna Tipo de la Visor de eventos de un registro. Este parámetro indica si el tipo de evento es error, advertencia, información, auditoría correcta o auditoría de error.

Debe establecer la propiedad en EventLog el Source componente para poder escribir entradas en el registro. Debe crear y configurar el origen del evento antes de escribir la primera entrada con el origen.

Cree el nuevo origen de eventos durante la instalación de la aplicación. Esto permite que el sistema operativo actualice su lista de orígenes de eventos registrados y su configuración. Si el sistema operativo no ha actualizado su lista de orígenes de eventos e intenta escribir un evento con el nuevo origen, se producirá un error en la operación de escritura. Puede configurar un nuevo origen mediante o EventLogInstallermediante el CreateEventSource método . Debe tener derechos administrativos en el equipo para crear un nuevo origen de eventos.

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

Nota

Si no especifica un MachineName para la EventLog instancia antes de llamar a CreateEventSource o WriteEntry, se asume el equipo local (".").

Si el sistema necesita registrar mediante Source una llamada a WriteEntry y la propiedad no se ha establecido en EventLog la Log instancia, el registro tiene como valor predeterminado el registro de aplicación.

Nota

Muchas excepciones enumeradas anteriormente se generan mediante errores generados durante el proceso de registro de Source.

El origen debe configurarse para escribir entradas localizadas o para escribir cadenas directas. El WriteEntry método escribe la cadena especificada directamente en el registro de eventos; no usa un archivo de recursos de mensaje localizable. Use el WriteEvent método para escribir eventos mediante un archivo de recursos de mensaje localizado.

Si la aplicación escribe entradas con identificadores de recursos y valores de cadena, debe registrar dos orígenes independientes. Por ejemplo, configure un origen con archivos de recursos y después use ese origen en el WriteEvent método para escribir entradas mediante identificadores de recursos en el registro de eventos. A continuación, cree otro origen sin archivos de recursos y use ese origen en el WriteEntry método para escribir cadenas directamente en el registro de eventos mediante ese origen.

Nota

Si escribe una entrada en un equipo remoto, es posible que el valor del mensaje (la cadena de texto) no sea lo que espera si el equipo remoto no ejecuta .NET Framework.

Nota

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

Consulte también

Se aplica a

WriteEntry(String, EventLogEntryType)

Escribe en el registro de eventos una entrada de error, advertencia, información, auditoría correcta o auditoría incorrecta con el texto de mensaje dado.

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::EventLogEntryType type);
public void WriteEntry (string message, System.Diagnostics.EventLogEntryType type);
member this.WriteEntry : string * System.Diagnostics.EventLogEntryType -> unit
Public Sub WriteEntry (message As String, type As EventLogEntryType)

Parámetros

message
String

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

type
EventLogEntryType

Uno de los valores de EventLogEntryType.

Excepciones

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

La cadena de mensaje es más de 31.839 bytes (32.766 bytes en los sistemas operativos Windows anterior a Windows Vista).

o bien

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

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

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.

Ejemplos

En el ejemplo siguiente se escribe una entrada de advertencia en un registro de eventos, "MyNewLog", en el equipo local.

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   
   // Create an EventLog instance and assign its source.
   EventLog^ myLog = gcnew EventLog("MyNewLog");
   myLog->Source = "MyNewLogSource";
   
   // Write an informational entry to the event log.    
   myLog->WriteEntry( "Writing warning to event log.", EventLogEntryType::Warning );
}
using System;
using System.Diagnostics;
using System.Threading;

class MySample1
{

    public static void Main()
    {

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

        // Write an informational entry to the event log.
        myLog.WriteEntry("Writing warning to event log.", EventLogEntryType.Warning);
    }
}
Option Strict
Option Explicit

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        ' Create an EventLog instance and assign its source.
        Dim myLog As New EventLog("MyNewLog")
        myLog.Source = "MyNewLogSource"
        
        ' Write an informational entry to the event log.    
        myLog.WriteEntry("Writing warning to event log.", EventLogEntryType.Warning)
    End Sub
End Class

Comentarios

Use este método para escribir una entrada de un especificado EventLogEntryType en el registro de eventos. type Se indica mediante un icono y texto en la columna Tipo de la Visor de eventos de un registro.

Nota

La message cadena 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. Como un protocolo de Internet, la dirección de la versión 6 (IPv6) puede contener esta secuencia de caracteres, no se puede registrar un mensaje de evento que contenga una dirección IPv6.

Debe establecer la propiedad en EventLog el Source componente para poder escribir entradas en el registro. Debe crear y configurar el origen del evento antes de escribir la primera entrada con el origen.

Cree el nuevo origen de eventos durante la instalación de la aplicación. Esto permite que el sistema operativo actualice su lista de orígenes de eventos registrados y su configuración. Si el sistema operativo no ha actualizado su lista de orígenes de eventos e intenta escribir un evento con el nuevo origen, se producirá un error en la operación de escritura. Puede configurar un nuevo origen mediante o EventLogInstallermediante el CreateEventSource método . Debe tener derechos administrativos en el equipo para crear un nuevo origen de eventos.

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

Nota

Si no especifica un MachineName para la EventLog instancia antes de llamar a CreateEventSource o WriteEntry, se asume el equipo local (".").

Si el sistema necesita registrar mediante Source una llamada a WriteEntry y la propiedad no se ha establecido en EventLog la Log instancia, el registro tiene como valor predeterminado el registro de aplicación.

Nota

Muchas excepciones enumeradas anteriormente se generan mediante errores generados durante el proceso de registro de Source.

El origen debe configurarse para escribir entradas localizadas o para escribir cadenas directas. El WriteEntry método escribe la cadena especificada directamente en el registro de eventos; no usa un archivo de recursos de mensaje localizable. Use el WriteEvent método para escribir eventos mediante un archivo de recursos de mensaje localizado.

Si la aplicación escribe entradas con identificadores de recursos y valores de cadena, debe registrar dos orígenes independientes. Por ejemplo, configure un origen con archivos de recursos y después use ese origen en el WriteEvent método para escribir entradas mediante identificadores de recursos en el registro de eventos. A continuación, cree otro origen sin archivos de recursos y use ese origen en el WriteEntry método para escribir cadenas directamente en el registro de eventos mediante ese origen.

Nota

Si escribe una entrada en un equipo remoto, es posible que el valor del mensaje (la cadena de texto) no sea lo que espera si el equipo remoto no ejecuta .NET Framework.

Nota

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

Consulte también

Se aplica a

WriteEntry(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.

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID);
public void WriteEntry (string message, System.Diagnostics.EventLogEntryType type, int eventID);
member this.WriteEntry : string * System.Diagnostics.EventLogEntryType * int -> unit
Public Sub WriteEntry (message As String, type As EventLogEntryType, eventID As Integer)

Parámetros

message
String

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

type
EventLogEntryType

Uno de los valores de EventLogEntryType.

eventID
Int32

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

Excepciones

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 de mensaje es más de 31.839 bytes (32.766 bytes en los sistemas operativos Windows anterior a Windows Vista).

o bien

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

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

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.

Ejemplos

// Create an EventLog instance and assign its source.
EventLog^ myLog = gcnew 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 );
// 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);
' Create an EventLog instance and assign its source.
Dim myLog As 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)

Comentarios

Use este método para escribir una entrada con una aplicación definida en eventID el registro de eventos. 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 de cadena para ayudar al usuario a comprender lo que salió mal y sugerir qué acciones realizar.

Nota

La message cadena 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. Como un protocolo de Internet, la dirección de la versión 6 (IPv6) puede contener esta secuencia de caracteres, no se puede registrar un mensaje de evento que contenga una dirección IPv6.

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

Debe establecer la propiedad en EventLog el Source componente para poder escribir entradas en el registro. Debe crear y configurar el origen del evento antes de escribir la primera entrada con el origen.

Cree el nuevo origen de eventos durante la instalación de la aplicación. Esto permite que el sistema operativo actualice su lista de orígenes de eventos registrados y su configuración. Si el sistema operativo no ha actualizado su lista de orígenes de eventos e intenta escribir un evento con el nuevo origen, se producirá un error en la operación de escritura. Puede configurar un nuevo origen mediante o EventLogInstallermediante el CreateEventSource método . Debe tener derechos administrativos en el equipo para crear un nuevo origen de eventos.

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

Nota

Si no especifica un MachineName para la EventLog instancia antes de llamar a CreateEventSource o WriteEntry, se asume el equipo local (".").

Si el sistema necesita registrar mediante Source una llamada a WriteEntry y la propiedad no se ha establecido en EventLog la Log instancia, el registro tiene como valor predeterminado el registro de aplicación.

Nota

Muchas excepciones enumeradas anteriormente se generan mediante errores generados durante el proceso de registro de Source.

El origen debe configurarse para escribir entradas localizadas o para escribir cadenas directas. El WriteEntry método escribe la cadena especificada directamente en el registro de eventos; no usa un archivo de recursos de mensaje localizable. Use el WriteEvent método para escribir eventos mediante un archivo de recursos de mensaje localizado.

Si la aplicación escribe entradas con identificadores de recursos y valores de cadena, debe registrar dos orígenes independientes. Por ejemplo, configure un origen con archivos de recursos y después use ese origen en el WriteEvent método para escribir entradas mediante identificadores de recursos en el registro de eventos. A continuación, cree otro origen sin archivos de recursos y use ese origen en el WriteEntry método para escribir cadenas directamente en el registro de eventos mediante ese origen.

Nota

Si escribe una entrada en un equipo remoto, es posible que el valor del mensaje (la cadena de texto) no sea lo que espera si el equipo remoto no ejecuta .NET Framework.

Nota

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

Consulte también

Se aplica a

WriteEntry(String, String)

Escribe una entrada de tipo de información con un texto de mensaje determinado en el registro de eventos utilizando el origen de eventos registrado que se haya especificado.

public:
 static void WriteEntry(System::String ^ source, System::String ^ message);
public static void WriteEntry (string source, string message);
static member WriteEntry : string * string -> unit
Public Shared Sub WriteEntry (source As String, message As String)

Parámetros

source
String

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

message
String

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

Excepciones

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

o bien

El valor source es null.

o bien

La cadena de mensaje es más de 31.839 bytes (32.766 bytes en los sistemas operativos Windows anterior a Windows Vista).

o bien

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

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

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.

Ejemplos

En el ejemplo siguiente se crea el origen MySource si aún no existe y se escribe una entrada en el registro de eventos MyNewLog.

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   
   // Create the source, if it does not already exist.
   if (  !EventLog::SourceExists( "MySource" ) )
   {
      EventLog::CreateEventSource( "MySource", "myNewLog" );
      Console::WriteLine( "CreatingEventSource" );
   }

   
   // Write an informational entry to the event log.    
   EventLog::WriteEntry( "MySource", "Writing to event log." );
}
using System;
using System.Diagnostics;
using System.Threading;

class MySample
{

    public static void Main()
    {

        // 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("CreatingEventSource");
            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;
        }

        // Write an informational entry to the event log.
        EventLog.WriteEntry("MySource", "Writing to event log.");
    }
}
Option Strict
Option Explicit

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        ' Create the source, if it does not already exist.
        If Not EventLog.SourceExists("MySource") Then
            EventLog.CreateEventSource("MySource", "myNewLog")
            Console.WriteLine("CreatingEventSource")
        End If
        
        
        ' Write an informational entry to the event log.    
        EventLog.WriteEntry("MySource", "Writing to event log.")
    End Sub
End Class

Comentarios

Use este método para escribir una entrada de información en el registro de eventos mediante un origen que ya está registrado como origen de eventos para el registro adecuado. Si desea especificar cualquier otro EventLogEntryType, use una sobrecarga diferente de WriteEntry.

Debe crear y configurar el origen del evento antes de escribir la primera entrada con el origen. Cree el nuevo origen de eventos durante la instalación de la aplicación. Esto permite que el sistema operativo actualice su lista de orígenes de eventos registrados y su configuración. Si el sistema operativo no ha actualizado su lista de orígenes de eventos e intenta escribir un evento con el nuevo origen, se producirá un error en la operación de escritura. Puede configurar un nuevo origen mediante o EventLogInstallermediante el CreateEventSource método . Debe tener derechos administrativos en el equipo para crear un nuevo origen de eventos.

El origen debe configurarse para escribir entradas localizadas o para escribir cadenas directas. El WriteEntry método escribe la cadena especificada directamente en el registro de eventos; no usa un archivo de recursos de mensaje localizable. Use el WriteEvent método para escribir eventos mediante un archivo de recursos de mensaje localizado.

Si la aplicación escribe entradas con identificadores de recursos y valores de cadena, debe registrar dos orígenes independientes. Por ejemplo, configure un origen con archivos de recursos y después use ese origen en el WriteEvent método para escribir entradas mediante identificadores de recursos en el registro de eventos. A continuación, cree otro origen sin archivos de recursos y use ese origen en el WriteEntry método para escribir cadenas directamente en el registro de eventos mediante ese origen.

Nota

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

La message cadena 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. Como un protocolo de Internet, la dirección de la versión 6 (IPv6) puede contener esta secuencia de caracteres, no se puede registrar un mensaje de evento que contenga una dirección IPv6.

Consulte también

Se aplica a

WriteEntry(String)

Escribe una entrada de tipo de información, con un texto de mensaje determinado, en el registro de eventos.

public:
 void WriteEntry(System::String ^ message);
public void WriteEntry (string message);
member this.WriteEntry : string -> unit
Public Sub WriteEntry (message As String)

Parámetros

message
String

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

Excepciones

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

La cadena de mensaje es más de 31.839 bytes (32.766 bytes en los sistemas operativos Windows anterior a Windows Vista).

o bien

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

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

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.

Ejemplos

En el ejemplo siguiente se crea el origen MySource si aún no existe y se escribe una entrada en el registro de eventos MyNewLog.

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   
   // 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( "CreatingEventSource" );
      // The source is created.  Exit the application to allow it to be registered.
      return 0;
   }

   
   // Create an EventLog instance and assign its source.
   EventLog^ myLog = gcnew EventLog;
   myLog->Source = "MySource";
   
   // Write an informational entry to the event log.    
   myLog->WriteEntry( "Writing to event log." );
}
using System;
using System.Diagnostics;
using System.Threading;

class MySample{

    public static void Main(){

        // 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("CreatedEventSource");
            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;
        }

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

        // Write an informational entry to the event log.
        myLog.WriteEntry("Writing to event log.");
    }
}
Option Explicit
Option Strict

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        
        If Not EventLog.SourceExists("MySource") Then
            ' Create the source, if it does not already exist.
            ' 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("CreatingEventSource")
            'The source is created.  Exit the application to allow it to be registered.
            Return
        End If
        
        ' Create an EventLog instance and assign its source.
        Dim myLog As New EventLog()
        myLog.Source = "MySource"
        
        ' Write an informational entry to the event log.    
        myLog.WriteEntry("Writing to event log.")
    End Sub
End Class

Comentarios

Use este método para escribir una entrada de información en el registro de eventos asociado a esta EventLog instancia. Si desea especificar cualquier otro EventLogEntryType, use una sobrecarga diferente de WriteEntry.

Nota

La message cadena 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. Como un protocolo de Internet, la dirección de la versión 6 (IPv6) puede contener esta secuencia de caracteres, no se puede registrar un mensaje de evento que contenga una dirección IPv6.

Debe establecer la propiedad en EventLog el Source componente para poder escribir entradas en el registro. Debe crear y configurar el origen del evento antes de escribir la primera entrada con el origen.

Cree el nuevo origen de eventos durante la instalación de la aplicación. Esto permite que el sistema operativo actualice su lista de orígenes de eventos registrados y su configuración. Si el sistema operativo no ha actualizado su lista de orígenes de eventos e intenta escribir un evento con el nuevo origen, se producirá un error en la operación de escritura. Puede configurar un nuevo origen mediante o EventLogInstallermediante el CreateEventSource método . Debe tener derechos administrativos en el equipo para crear un nuevo origen de eventos.

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

Nota

Si no especifica un MachineName para la EventLog instancia antes de llamar a CreateEventSource o WriteEntry, se asume el equipo local (".").

Si el sistema necesita registrar mediante Source una llamada a WriteEntry y la propiedad no se ha establecido en EventLog la Log instancia, el registro tiene como valor predeterminado el registro de aplicación.

Nota

Muchas de las excepciones enumeradas anteriormente se generan mediante errores generados durante el proceso de registro de Source.

El origen debe configurarse para escribir entradas localizadas o para escribir cadenas directas. El WriteEntry método escribe la cadena especificada directamente en el registro de eventos; no usa un archivo de recursos de mensaje localizable. Use el WriteEvent método para escribir eventos mediante un archivo de recursos de mensaje localizado.

Si la aplicación escribe entradas con identificadores de recursos y valores de cadena, debe registrar dos orígenes independientes. Por ejemplo, configure un origen con archivos de recursos y después use ese origen en el WriteEvent método para escribir entradas mediante identificadores de recursos en el registro de eventos. A continuación, cree otro origen sin archivos de recursos y use ese origen en el WriteEntry método para escribir cadenas directamente en el registro de eventos mediante ese origen.

Nota

Si escribe una entrada en un equipo remoto, es posible que el valor del mensaje (la cadena de texto) no sea lo que espera si el equipo remoto no ejecuta .NET Framework.

Nota

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

Consulte también

Se aplica a

WriteEntry(String, String, EventLogEntryType)

Escribe en el registro de eventos una entrada de error, advertencia, información, auditoría correcta o auditoría incorrecta con el texto de mensaje dado mediante el origen de eventos registrado especificado.

public:
 static void WriteEntry(System::String ^ source, System::String ^ message, System::Diagnostics::EventLogEntryType type);
public static void WriteEntry (string source, string message, System.Diagnostics.EventLogEntryType type);
static member WriteEntry : string * string * System.Diagnostics.EventLogEntryType -> unit
Public Shared Sub WriteEntry (source As String, message As String, type As EventLogEntryType)

Parámetros

source
String

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

message
String

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

type
EventLogEntryType

Uno de los valores de EventLogEntryType.

Excepciones

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

o bien

El valor source es null.

o bien

La cadena de mensaje es más de 31.839 bytes (32.766 bytes en los sistemas operativos Windows anterior a Windows Vista).

o bien

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

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

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.

Ejemplos

En el ejemplo siguiente se escribe una entrada de advertencia en un registro de eventos, "MyNewLog", en el equipo local.

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   
   // Write an informational entry to the event log.    
   EventLog::WriteEntry( "MySource", "Writing warning to event log.", EventLogEntryType::Warning );
}
using System;
using System.Diagnostics;
using System.Threading;

class MySample2
{

    public static void Main()
    {

        // Write an informational entry to the event log.
        EventLog.WriteEntry("MySource",
            "Writing warning to event log.",
            EventLogEntryType.Warning);
    }
}
Option Explicit
Option Strict

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        ' Write an informational entry to the event log.    
        EventLog.WriteEntry("MySource", "Writing warning to event log.", _
            EventLogEntryType.Warning)
    End Sub
End Class

Comentarios

Use este método para escribir una entrada de un especificado EventLogEntryType en el registro de eventos, utilizando un origen ya registrado como origen de eventos para el registro adecuado. type Se indica mediante un icono y texto en la columna Tipo de la Visor de eventos de un registro.

Nota

La message cadena 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. Como un protocolo de Internet, la dirección de la versión 6 (IPv6) puede contener esta secuencia de caracteres, no se puede registrar un mensaje de evento que contenga una dirección IPv6.

Debe crear y configurar el origen del evento antes de escribir la primera entrada con el origen. Cree el nuevo origen de eventos durante la instalación de la aplicación. Esto permite que el sistema operativo actualice su lista de orígenes de eventos registrados y su configuración. Si el sistema operativo no ha actualizado su lista de orígenes de eventos e intenta escribir un evento con el nuevo origen, se producirá un error en la operación de escritura. Puede configurar un nuevo origen mediante o EventLogInstallermediante el CreateEventSource método . Debe tener derechos administrativos en el equipo para crear un nuevo origen de eventos.

El origen debe configurarse para escribir entradas localizadas o para escribir cadenas directas. El WriteEntry método escribe la cadena especificada directamente en el registro de eventos; no usa un archivo de recursos de mensaje localizable. Use el WriteEvent método para escribir eventos mediante un archivo de recursos de mensaje localizado.

Si la aplicación escribe entradas con identificadores de recursos y valores de cadena, debe registrar dos orígenes independientes. Por ejemplo, configure un origen con archivos de recursos y después use ese origen en el WriteEvent método para escribir entradas mediante identificadores de recursos en el registro de eventos. A continuación, cree otro origen sin archivos de recursos y use ese origen en el WriteEntry método para escribir cadenas directamente en el registro de eventos mediante ese origen.

Nota

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

Consulte también

Se aplica a