EventLog.WriteEntry Método

Definición

Espacio de nombres:: System.Diagnostics

Ensamblado:: System.Diagnostics.EventLog.dll

Ensamblado:: System.dll

Paquete:: System.Diagnostics.EventLog v11.0.0-preview.2.26159.112

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 una entrada en el registro de eventos.

Sobrecargas

Nombre	Description
WriteEntry(String, String, EventLogEntryType, Int32, Int16, Byte[])	Escribe una entrada con el texto del mensaje especificado, el identificador de evento definido por la aplicación y la categoría definida por la aplicación en el registro de eventos (mediante el origen de eventos registrado especificado) y anexa datos binarios al mensaje.
WriteEntry(String, String, EventLogEntryType, Int32, Int16)	Escribe una entrada con el texto del mensaje, el identificador de evento definido por la aplicación y la categoría definida por la aplicación en el registro de eventos, mediante el origen de eventos registrado especificado. `category` El Visor de eventos puede usar para filtrar eventos en el registro.
WriteEntry(String, EventLogEntryType, Int32, Int16, Byte[])	Escribe una entrada con el texto del mensaje, el identificador de eventos definido por la aplicación y la categoría definida por la aplicación en el registro de eventos y anexa datos binarios al mensaje.
WriteEntry(String, String, EventLogEntryType, Int32)	Escribe una entrada con el texto del mensaje y el identificador de evento definido por la aplicación especificados en el registro de eventos mediante el origen de eventos registrado especificado.
WriteEntry(String, EventLogEntryType, Int32, Int16)	Escribe una entrada con el texto del mensaje, el identificador de evento definido por la aplicación y la categoría definida por la aplicación en el registro de eventos.
WriteEntry(String, EventLogEntryType)	Escribe una entrada de error, advertencia, información, auditoría correcta o auditoría de error con el texto del mensaje especificado en el registro de eventos.
WriteEntry(String, EventLogEntryType, Int32)	Escribe una entrada con el texto del mensaje especificado y el identificador de evento definido por la aplicación en el registro de eventos.
WriteEntry(String, String)	Escribe una entrada de tipo de información con el texto del mensaje especificado en el registro de eventos mediante el origen de eventos registrado especificado.
WriteEntry(String)	Escribe una entrada de tipo de información, con el texto del mensaje especificado, en el registro de eventos.
WriteEntry(String, String, EventLogEntryType)	Escribe una entrada de error, advertencia, información, auditoría correcta o auditoría de error con el texto del mensaje especificado en el registro de eventos mediante el origen de eventos registrado especificado.

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

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Escribe una entrada con el texto del mensaje especificado, el identificador de evento definido por la aplicación y la categoría definida por la aplicación en el registro de eventos (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 por 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 EventLogEntryType valores.

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 contiene los datos binarios asociados a la entrada.

Excepciones

ArgumentException

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

O bien

El source valor es null.

O bien

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

O bien

La cadena de mensaje tiene más de 31 839 bytes (32 766 bytes en sistemas operativos Windows antes de Windows Vista).

O bien

El nombre de origen da como resultado una ruta de acceso de clave del Registro de más de 254 caracteres.

InvalidEnumArgumentException

type no es un valor válido EventLogEntryType.

InvalidOperationException

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

Win32Exception

El sistema operativo notificó un error al escribir la entrada del evento en el registro de eventos. Un código de error de Windows no está disponible.

Ejemplos

//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 mediante un origen ya registrado como origen de eventos para el registro adecuado. El Visor de eventos no interpreta estos datos; muestra 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 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 de categoría numérico 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 qué acciones realizar.

Por último, 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 del 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 EventLogInstallero 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 con 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)

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Escribe una entrada con el texto del mensaje, el identificador de evento definido por la aplicación y la categoría definida por la aplicación en el registro de eventos, mediante el origen de eventos registrado especificado. category El Visor de eventos puede usar para filtrar eventos en el 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 por 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 EventLogEntryType valores.

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

ArgumentException

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

O bien

El source valor es null.

O bien

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

O bien

La cadena de mensaje tiene más de 31 839 bytes (32 766 bytes en sistemas operativos Windows antes de Windows Vista).

O bien

El nombre de origen da como resultado una ruta de acceso de clave del Registro de más de 254 caracteres.

InvalidOperationException

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

InvalidEnumArgumentException

type no es un valor válido EventLogEntryType.

Win32Exception

El sistema operativo notificó un error al escribir la entrada del evento en el registro de eventos. Un código de error de Windows no está 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);

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 en category 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 puede usar la categoría como identificador de recurso para mostrar una cadena de categoría localizada.

Nota:

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 qué ha ido mal y sugerir qué acciones realizar.

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, Byte[])

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Escribe una entrada con el texto del mensaje, el identificador de eventos definido por la aplicación y la categoría definida por la aplicación en el registro de eventos 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 EventLogEntryType valores.

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 contiene los datos binarios asociados a la entrada.

Excepciones

ArgumentException

No Source se ha establecido la propiedad de .EventLog

O bien

El método intentó registrar un nuevo origen de eventos, pero el nombre del equipo en MachineName no es válido.

O bien

El origen ya está registrado para un registro de eventos diferente.

O bien

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

O bien

La cadena de mensaje tiene más de 31 839 bytes (32 766 bytes en sistemas operativos Windows antes de Windows Vista).

O bien

El nombre de origen da como resultado una ruta de acceso de clave del Registro de más de 254 caracteres.

InvalidOperationException

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

InvalidEnumArgumentException

type no es un valor válido EventLogEntryType.

Win32Exception

El sistema operativo notificó un error al escribir la entrada del evento en el registro de eventos. Un código de error de Windows no está disponible.

Ejemplos

// 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; muestra datos sin procesar solo 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.

Nota:

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 EventLogInstallero mediante 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 a Source través de una llamada a WriteEntry y la propiedad no se ha establecido en EventLog la Log instancia, el registro se establece de forma predeterminada en el registro de aplicación.

Nota:

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

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)

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

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

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 por 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 EventLogEntryType valores.

eventID: Int32

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

Excepciones

ArgumentException

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

O bien

El source valor es null.

O bien

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

O bien

La cadena de mensaje tiene más de 31 839 bytes (32 766 bytes en sistemas operativos Windows antes de Windows Vista).

O bien

El nombre de origen da como resultado una ruta de acceso de clave del Registro de más de 254 caracteres.

InvalidOperationException

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

InvalidEnumArgumentException

type no es un valor válido EventLogEntryType.

Win32Exception

El sistema operativo notificó un error al escribir la entrada del evento en el registro de eventos. Un código de error de Windows no está disponible.

Ejemplos

// 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 en eventID el registro de eventos mediante un origen ya registrado como origen de eventos para el registro adecuado. , eventIDjunto 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 presentan estas cadenas al usuario para ayudar al usuario a comprender qué ha ido mal y sugerir qué acciones realizar.

Nota:

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 del 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.

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)

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

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

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 EventLogEntryType valores.

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

ArgumentException

No Source se ha establecido la propiedad de .EventLog

O bien

El método intentó registrar un nuevo origen de eventos, pero el nombre del equipo en MachineName no es válido.

O bien

El origen ya está registrado para un registro de eventos diferente.

O bien

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

O bien

La cadena de mensaje tiene más de 31 839 bytes (32 766 bytes en sistemas operativos Windows antes de Windows Vista).

O bien

El nombre de origen da como resultado una ruta de acceso de clave del Registro de más de 254 caracteres.

InvalidOperationException

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

InvalidEnumArgumentException

type no es un valor válido EventLogEntryType.

Win32Exception

El sistema operativo notificó un error al escribir la entrada del evento en el registro de eventos. Un código de error de Windows no está disponible.

Ejemplos

// 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 puede usar la categoría como identificador de recurso para mostrar una cadena de categoría localizada.

Nota:

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

Nota:

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

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)

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

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

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 EventLogEntryType valores.

Excepciones

ArgumentException

No Source se ha establecido la propiedad de .EventLog

O bien

El método intentó registrar un nuevo origen de eventos, pero el nombre del equipo en MachineName no es válido.

O bien

El origen ya está registrado para un registro de eventos diferente.

O bien

La cadena de mensaje tiene más de 31 839 bytes (32 766 bytes en sistemas operativos Windows antes de Windows Vista).

O bien

El nombre de origen da como resultado una ruta de acceso de clave del Registro de más de 254 caracteres.

InvalidEnumArgumentException

type no es un valor válido EventLogEntryType.

InvalidOperationException

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

Win32Exception

El sistema operativo notificó un error al escribir la entrada del evento en el registro de eventos. Un código de error de Windows no está disponible.

Ejemplos

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

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 del Visor de eventos de un registro.

Nota:

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

Nota:

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

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)

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Escribe una entrada con el texto del mensaje especificado y el identificador de evento definido por la aplicación 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 EventLogEntryType valores.

eventID: Int32

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

Excepciones

ArgumentException

No Source se ha establecido la propiedad de .EventLog

O bien

El método intentó registrar un nuevo origen de eventos, pero el nombre del equipo en MachineName no es válido.

O bien

El origen ya está registrado para un registro de eventos diferente.

O bien

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

O bien

La cadena de mensaje tiene más de 31 839 bytes (32 766 bytes en sistemas operativos Windows antes de Windows Vista).

O bien

El nombre de origen da como resultado una ruta de acceso de clave del Registro de más de 254 caracteres.

InvalidOperationException

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

InvalidEnumArgumentException

type no es un valor válido EventLogEntryType.

Win32Exception

El sistema operativo notificó un error al escribir la entrada del evento en el registro de eventos. Un código de error de Windows no está disponible.

Ejemplos

// 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 qué ha ido mal y sugerir qué acciones realizar.

Nota:

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 del 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.

Nota:

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

Nota:

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

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)

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Escribe una entrada de tipo de información con el texto del mensaje especificado en el registro de eventos mediante el origen de eventos registrado 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 por 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

ArgumentException

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

O bien

El source valor es null.

O bien

La cadena de mensaje tiene más de 31 839 bytes (32 766 bytes en sistemas operativos Windows antes de Windows Vista).

O bien

El nombre de origen da como resultado una ruta de acceso de clave del Registro de más de 254 caracteres.

InvalidOperationException

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

Win32Exception

El sistema operativo notificó un error al escribir la entrada del evento en el registro de eventos. Un código de error de Windows no está 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;
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.

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)

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Escribe una entrada de tipo de información, con el texto del mensaje especificado, 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

ArgumentException

No Source se ha establecido la propiedad de .EventLog

O bien

El método intentó registrar un nuevo origen de eventos, pero el nombre del equipo en MachineName no es válido.

O bien

El origen ya está registrado para un registro de eventos diferente.

O bien

La cadena de mensaje tiene más de 31 839 bytes (32 766 bytes en sistemas operativos Windows antes de Windows Vista).

O bien

El nombre de origen da como resultado una ruta de acceso de clave del Registro de más de 254 caracteres.

InvalidOperationException

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

Win32Exception

El sistema operativo notificó un error al escribir la entrada del evento en el registro de eventos. Un código de error de Windows no está 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;
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:

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

Nota:

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

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)

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Escribe una entrada de error, advertencia, información, auditoría correcta o auditoría de error con el texto del mensaje especificado en el registro de eventos 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 por 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 EventLogEntryType valores.

Excepciones

ArgumentException

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

O bien

El source valor es null.

O bien

La cadena de mensaje tiene más de 31 839 bytes (32 766 bytes en sistemas operativos Windows antes de Windows Vista).

O bien

El nombre de origen da como resultado una ruta de acceso de clave del Registro de más de 254 caracteres.

InvalidOperationException

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

InvalidEnumArgumentException

type no es un valor válido EventLogEntryType.

Win32Exception

El sistema operativo notificó un error al escribir la entrada del evento en el registro de eventos. Un código de error de Windows no está disponible.

Ejemplos

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

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 del Visor de eventos de un registro.

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

Comentarios

Resultoulle útil esta páxina?

Compartir por

EventLog.WriteEntry Método

Definición

Sobrecargas

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

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

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

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

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

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

WriteEntry(String, String, EventLogEntryType, Int32)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

WriteEntry(String, EventLogEntryType, Int32, Int16)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

WriteEntry(String, EventLogEntryType)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

WriteEntry(String, EventLogEntryType, Int32)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

WriteEntry(String, String)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

WriteEntry(String)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

WriteEntry(String, String, EventLogEntryType)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Comentarios