EventLog.WriteEntry Método

Source:

EventLog.cs

Source:

EventLog.cs

Source:

EventLog.cs

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

Excepciones

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.

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

Consulte también

• EventLogEntryType
• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries

Source:

EventLog.cs

Source:

EventLog.cs

Source:

EventLog.cs

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

Excepciones

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.

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

Consulte también

• EventLogEntryType
• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries

Source:

EventLog.cs

Source:

EventLog.cs

Source:

EventLog.cs

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

Excepciones

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.

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.

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

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.

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.

Consulte también

• EventLogEntryType
• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries

Source:

EventLog.cs

Source:

EventLog.cs

Source:

EventLog.cs

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

Excepciones

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 en eventID el registro de eventos, utilizando 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 qué ha ido mal y sugerir qué acciones realizar.

Además del identificador de evento, esta sobrecarga de WriteEntry le 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. Create 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.

Consulte también

• EventLogEntryType
• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries

Source:

EventLog.cs

Source:

EventLog.cs

Source:

EventLog.cs

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

Excepciones

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 category en 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.

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 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 establecer la propiedad en el SourceEventLog 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.

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

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.

Si el sistema necesita registrar el Source a través de 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.

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.

Consulte también

• EventLogEntryType
• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries

Source:

EventLog.cs

Source:

EventLog.cs

Source:

EventLog.cs

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

Excepciones

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.

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.

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

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.

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.

Consulte también

• EventLogEntryType
• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries

Source:

EventLog.cs

Source:

EventLog.cs

Source:

EventLog.cs

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

Excepciones

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.

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.

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

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.

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.

Consulte también

• EventLogEntryType
• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries

Source:

EventLog.cs

Source:

EventLog.cs

Source:

EventLog.cs

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

Excepciones

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

Consulte también

• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries

Source:

EventLog.cs

Source:

EventLog.cs

Source:

EventLog.cs

public:
 void WriteEntry(System::String ^ message);

public void WriteEntry (string message);

member this.WriteEntry : string -> unit

Public Sub WriteEntry (message As String)

Parámetros

Excepciones

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.

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.

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

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.

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.

Consulte también

• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries

Source:

EventLog.cs

Source:

EventLog.cs

Source:

EventLog.cs

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

Excepciones

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.

Debe crear y configurar el origen del evento antes de escribir la primera entrada con el origen. Create 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.

Consulte también

• EventLogEntryType
• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries