EventLog.WriteEntry Methode

Quelle:

EventLog.cs

Quelle:

EventLog.cs

Quelle:

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())

Parameter

Ausnahmen

Beispiele

//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)

Hinweise

Verwenden Sie diese Methode, um anwendungsdefinierte ereignisspezifische Daten in das Ereignisprotokoll zu schreiben, wobei eine Quelle verwendet wird, die bereits als Ereignisquelle für das entsprechende Protokoll registriert ist. Die Ereignisanzeige interpretiert diese Daten nicht. Rohdaten werden nur in einem kombinierten Hexadezimal- und Textformat angezeigt. Ereignisspezifische Daten sparsam verwenden; Fügen Sie es nur ein, wenn Sie sicher sind, dass es nützlich ist. Sie können auch ereignisspezifische Daten verwenden, um Informationen zu speichern, die die Anwendung unabhängig von der Ereignisanzeige verarbeiten kann. Sie können beispielsweise einen Viewer speziell für Ihre Ereignisse schreiben oder ein Programm schreiben, das die Protokolldatei scannt und Berichte erstellt, die Informationen aus den ereignisspezifischen Daten enthalten.

Zusätzlich zu den Binärdaten können Sie eine anwendungsdefinierte Kategorie und einen anwendungsdefinierte Ereignisbezeichner angeben. Die Ereignisanzeige verwendet die Kategorie, um von einer Ereignisquelle geschriebene Ereignisse zu filtern. Die Ereignisanzeige kann die Kategorie als numerischen Wert anzeigen oder die Kategorie als Ressourcenbezeichner verwenden, um eine lokalisierte Kategoriezeichenfolge anzuzeigen.

Um lokalisierte Kategoriezeichenfolgen im Ereignisanzeige anzuzeigen, müssen Sie eine Ereignisquelle verwenden, die mit einer Kategorieressourcendatei konfiguriert ist, und legen Sie in category der Kategorieressourcendatei auf einen Ressourcenbezeichner fest. Wenn die Ereignisquelle über keine konfigurierte Kategorieressourcendatei verfügt oder die angegebene category keine Zeichenfolge in der Kategorieressourcendatei indiziert, zeigt die Ereignisanzeige den numerischen Kategoriewert für diesen Eintrag an. Konfigurieren Sie die Kategorieressourcendatei zusammen mit der Anzahl der Kategoriezeichenfolgen in der Ressourcendatei mithilfe der EventLogInstaller - oder - EventSourceCreationData Klasse.

Ereignisbezeichner identifizieren zusammen mit der Ereignisquelle ein Ereignis eindeutig. Jede Anwendung kann eigene nummerierte Ereignisse und die Beschreibungszeichenfolgen definieren, denen sie zugeordnet sind. Ereignisanzeigen zeigen diese Zeichenfolgenwerte an, um dem Benutzer zu helfen, zu verstehen, was falsch gelaufen ist, und schlägt vor, welche Aktionen ausgeführt werden sollen.

Schließlich können Sie eine EventLogEntryType für das Ereignis angeben, das in das Ereignisprotokoll geschrieben wird. Wird type durch ein Symbol und Text in der Spalte Typ im Ereignisanzeige für ein Protokoll angegeben. Dieser Parameter gibt an, ob der Ereignistyp Fehler, Warnung, Informationen, Erfolgsüberwachung oder Fehlerüberwachung ist.

Sie müssen die Ereignisquelle erstellen und konfigurieren, bevor Sie den ersten Eintrag mit der Quelle schreiben. Create die neue Ereignisquelle während der Installation Ihrer Anwendung. Dadurch kann das Betriebssystem die Liste der registrierten Ereignisquellen und deren Konfiguration aktualisieren. Wenn das Betriebssystem die Liste der Ereignisquellen nicht aktualisiert hat und Sie versuchen, ein Ereignis mit der neuen Quelle zu schreiben, schlägt der Schreibvorgang fehl. Sie können eine neue Quelle mit oder EventLogInstallermit der CreateEventSource -Methode konfigurieren. Sie müssen über Administratorrechte auf dem Computer verfügen, um eine neue Ereignisquelle erstellen zu können.

Die Quelle muss entweder zum Schreiben lokalisierter Einträge oder zum Schreiben direkter Zeichenfolgen konfiguriert werden. Die WriteEntry -Methode schreibt die angegebene Zeichenfolge direkt in das Ereignisprotokoll und verwendet keine lokalisierbare Nachrichtenressourcendatei. Verwenden Sie die WriteEvent -Methode, um Ereignisse mithilfe einer lokalisierten Nachrichtenressourcendatei zu schreiben.

Wenn Ihre Anwendung Einträge mit Ressourcenbezeichnern und Zeichenfolgenwerten schreibt, müssen Sie zwei separate Quellen registrieren. Konfigurieren Sie beispielsweise eine Quelle mit Ressourcendateien, und verwenden Sie diese Quelle dann in der WriteEvent -Methode, um Einträge mithilfe von Ressourcenbezeichnern in das Ereignisprotokoll zu schreiben. Erstellen Sie dann eine andere Quelle ohne Ressourcendateien, und verwenden Sie diese Quelle in der WriteEntry -Methode, um Zeichenfolgen mithilfe dieser Quelle direkt in das Ereignisprotokoll zu schreiben.

Weitere Informationen

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

Quelle:

EventLog.cs

Quelle:

EventLog.cs

Quelle:

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)

Parameter

Ausnahmen

Beispiele

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)

Hinweise

Verwenden Sie diese Methode, um einen Eintrag mit einer Anwendung zu schreiben, die in das Ereignisprotokoll definiert category ist, wobei eine Quelle verwendet wird, die bereits als Ereignisquelle für das entsprechende Protokoll registriert ist. Die Ereignisanzeige verwendet die Kategorie, um von einer Ereignisquelle geschriebene Ereignisse zu filtern. Die Ereignisanzeige kann die Kategorie als numerischen Wert anzeigen oder die Kategorie als Ressourcenbezeichner verwenden, um eine lokalisierte Kategoriezeichenfolge anzuzeigen.

Um lokalisierte Kategoriezeichenfolgen im Ereignisanzeige anzuzeigen, müssen Sie eine Ereignisquelle verwenden, die mit einer Kategorieressourcendatei konfiguriert ist, und legen Sie in category der Kategorieressourcendatei auf einen Ressourcenbezeichner fest. Wenn die Ereignisquelle über keine konfigurierte Kategorieressourcendatei verfügt oder die angegebene category keine Zeichenfolge in der Kategorieressourcendatei indiziert, zeigt die Ereignisanzeige den numerischen Kategoriewert für diesen Eintrag an. Konfigurieren Sie die Kategorieressourcendatei zusammen mit der Anzahl der Kategoriezeichenfolgen in der Ressourcendatei mithilfe der EventLogInstaller - oder - EventSourceCreationData Klasse.

Zusätzlich zur Kategorie können Sie einen Ereignisbezeichner für das Ereignis angeben, das in das Ereignisprotokoll geschrieben wird. Ereignisbezeichner identifizieren zusammen mit der Ereignisquelle ein Ereignis eindeutig. Jede Anwendung kann eigene nummerierte Ereignisse und die Beschreibungszeichenfolgen definieren, denen sie zugeordnet sind. Ereignisanzeigen zeigen diese Zeichenfolgenwerte an, um dem Benutzer zu helfen, zu verstehen, was falsch gelaufen ist, und schlägt vor, welche Aktionen ausgeführt werden sollen.

Schließlich können Sie eine EventLogEntryType für das Ereignis angeben, das in das Ereignisprotokoll geschrieben wird. Wird type durch ein Symbol und Text in der Spalte Typ im Ereignisanzeige für ein Protokoll angegeben. Dieser Parameter gibt an, ob der Ereignistyp Fehler, Warnung, Informationen, Erfolgsüberwachung oder Fehlerüberwachung ist.

Sie müssen die Ereignisquelle erstellen und konfigurieren, bevor Sie den ersten Eintrag mit der Quelle schreiben. Create die neue Ereignisquelle während der Installation Ihrer Anwendung. Dadurch kann das Betriebssystem die Liste der registrierten Ereignisquellen und deren Konfiguration aktualisieren. Wenn das Betriebssystem die Liste der Ereignisquellen nicht aktualisiert hat und Sie versuchen, ein Ereignis mit der neuen Quelle zu schreiben, schlägt der Schreibvorgang fehl. Sie können eine neue Quelle mit oder EventLogInstallermit der CreateEventSource -Methode konfigurieren. Sie müssen über Administratorrechte auf dem Computer verfügen, um eine neue Ereignisquelle erstellen zu können.

Die Quelle muss entweder zum Schreiben lokalisierter Einträge oder zum Schreiben direkter Zeichenfolgen konfiguriert werden. Die WriteEntry -Methode schreibt die angegebene Zeichenfolge direkt in das Ereignisprotokoll und verwendet keine lokalisierbare Nachrichtenressourcendatei. Verwenden Sie die WriteEvent -Methode, um Ereignisse mithilfe einer lokalisierten Nachrichtenressourcendatei zu schreiben.

Wenn Ihre Anwendung Einträge mit Ressourcenbezeichnern und Zeichenfolgenwerten schreibt, müssen Sie zwei separate Quellen registrieren. Konfigurieren Sie beispielsweise eine Quelle mit Ressourcendateien, und verwenden Sie diese Quelle dann in der WriteEvent -Methode, um Einträge mithilfe von Ressourcenbezeichnern in das Ereignisprotokoll zu schreiben. Erstellen Sie dann eine andere Quelle ohne Ressourcendateien, und verwenden Sie diese Quelle in der WriteEntry -Methode, um Zeichenfolgen mithilfe dieser Quelle direkt in das Ereignisprotokoll zu schreiben.

Weitere Informationen

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

Quelle:

EventLog.cs

Quelle:

EventLog.cs

Quelle:

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())

Parameter

Ausnahmen

Beispiele

// 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)

Hinweise

Verwenden Sie diese Überladung, um anwendungsdefinierte ereignisspezifische Daten in das Ereignisprotokoll zu schreiben. Die Ereignisanzeige interpretiert diese Daten nicht. Rohdaten werden nur in einem kombinierten Hexadezimal- und Textformat angezeigt. Verwenden Sie ereignisspezifische Daten sparsam, auch nur, wenn Sie sicher sind, dass sie für jemanden, der das Problem debuggen, nützlich ist. Sie können auch ereignisspezifische Daten verwenden, um Informationen zu speichern, die die Anwendung unabhängig von der Ereignisanzeige verarbeiten kann. Sie können beispielsweise einen Viewer speziell für Ihre Ereignisse schreiben oder ein Programm schreiben, das die Protokolldatei scannt und Berichte erstellt, die Informationen aus den ereignisspezifischen Daten enthalten.

Zusätzlich zu den Binärdaten können Sie eine anwendungsdefinierte Kategorie und einen anwendungsdefinierte Ereignisbezeichner angeben. Die Ereignisanzeige verwendet die Kategorie, um von einer Ereignisquelle geschriebene Ereignisse zu filtern. Die Ereignisanzeige kann die Kategorie als numerischen Wert anzeigen oder die Kategorie als Ressourcenbezeichner verwenden, um eine lokalisierte Kategoriezeichenfolge anzuzeigen.

Um lokalisierte Kategoriezeichenfolgen im Ereignisanzeige anzuzeigen, müssen Sie eine Ereignisquelle verwenden, die mit einer Kategorieressourcendatei konfiguriert ist, und legen Sie in category der Kategorieressourcendatei auf einen Ressourcenbezeichner fest. Wenn die Ereignisquelle über keine konfigurierte Kategorieressourcendatei verfügt oder die angegebene category keine Zeichenfolge in der Kategorieressourcendatei indiziert, zeigt die Ereignisanzeige den numerischen Kategoriewert für diesen Eintrag an. Konfigurieren Sie die Kategorieressourcendatei zusammen mit der Anzahl der Kategoriezeichenfolgen in der Ressourcendatei mithilfe der EventLogInstaller - oder - EventSourceCreationData Klasse.

Ereignisbezeichner identifizieren zusammen mit der Ereignisquelle ein Ereignis eindeutig. Jede Anwendung kann eigene nummerierte Ereignisse und die Beschreibungszeichenfolgen definieren, denen sie zugeordnet sind. Ereignisanzeigen zeigen diese Zeichenfolgenwerte an, um dem Benutzer zu helfen, zu verstehen, was falsch gelaufen ist, und schlägt vor, welche Aktionen ausgeführt werden sollen.

Schließlich können Sie eine EventLogEntryType für das Ereignis angeben, das in das Ereignisprotokoll geschrieben wird. Wird type durch ein Symbol und Text in der Spalte Typ im Ereignisanzeige für ein Protokoll angegeben. Dieser Parameter gibt an, ob der Ereignistyp Fehler, Warnung, Informationen, Erfolgsüberwachung oder Fehlerüberwachung ist.

Sie müssen die Source -Eigenschaft für Ihre EventLog Komponente festlegen, bevor Sie Einträge in das Protokoll schreiben können. Sie müssen die Ereignisquelle erstellen und konfigurieren, bevor Sie den ersten Eintrag mit der Quelle schreiben.

Create die neue Ereignisquelle während der Installation Ihrer Anwendung. Dadurch kann das Betriebssystem die Liste der registrierten Ereignisquellen und deren Konfiguration aktualisieren. Wenn das Betriebssystem die Liste der Ereignisquellen nicht aktualisiert hat und Sie versuchen, ein Ereignis mit der neuen Quelle zu schreiben, schlägt der Schreibvorgang fehl. Sie können eine neue Quelle mit oder EventLogInstallermit der CreateEventSource -Methode konfigurieren. Sie müssen über Administratorrechte auf dem Computer verfügen, um eine neue Ereignisquelle erstellen zu können.

Wenn die in der Source -Eigenschaft dieses EventLog instance angegebene Quelle nicht auf dem Computer registriert ist, auf den Ihre Komponente schreibt, ruft die Quelle auf CreateEventSource und WriteEntry registriert sie.

Wenn das System die Source über einen Aufruf WriteEntry von registrieren muss und die Log -Eigenschaft nicht auf Ihrem EventLog instance festgelegt wurde, wird standardmäßig das Anwendungsprotokoll verwendet.

Die Quelle muss entweder zum Schreiben lokalisierter Einträge oder zum Schreiben direkter Zeichenfolgen konfiguriert werden. Die WriteEntry -Methode schreibt die angegebene Zeichenfolge direkt in das Ereignisprotokoll und verwendet keine lokalisierbare Nachrichtenressourcendatei. Verwenden Sie die WriteEvent -Methode, um Ereignisse mithilfe einer lokalisierten Nachrichtenressourcendatei zu schreiben.

Wenn Ihre Anwendung Einträge mit Ressourcenbezeichnern und Zeichenfolgenwerten schreibt, müssen Sie zwei separate Quellen registrieren. Konfigurieren Sie beispielsweise eine Quelle mit Ressourcendateien, und verwenden Sie diese Quelle dann in der WriteEvent -Methode, um Einträge mithilfe von Ressourcenbezeichnern in das Ereignisprotokoll zu schreiben. Erstellen Sie dann eine andere Quelle ohne Ressourcendateien, und verwenden Sie diese Quelle in der WriteEntry -Methode, um Zeichenfolgen mithilfe dieser Quelle direkt in das Ereignisprotokoll zu schreiben.

Weitere Informationen

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

Quelle:

EventLog.cs

Quelle:

EventLog.cs

Quelle:

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)

Parameter

Ausnahmen

Beispiele

// 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)

Hinweise

Verwenden Sie diese Methode, um einen Eintrag mit einer Anwendung zu schreiben, die in das Ereignisprotokoll definiert eventID ist, wobei eine Quelle verwendet wird, die bereits als Ereignisquelle für das entsprechende Protokoll registriert ist. Zusammen eventIDmit der Quelle wird ein Ereignis eindeutig identifiziert. Jede Anwendung kann eigene nummerierte Ereignisse und die Beschreibungszeichenfolgen definieren, denen sie zugeordnet sind. Ereignisanzeigen präsentieren dem Benutzer diese Zeichenfolgen, um dem Benutzer zu helfen, zu verstehen, was schief gelaufen ist, und schlägt vor, welche Aktionen ausgeführt werden sollen.

Zusätzlich zum Ereignisbezeichner können Sie mit dieser Überladung von WriteEntry eine EventLogEntryType für das Ereignis angeben, das in das Ereignisprotokoll geschrieben wird. Wird type durch ein Symbol und Text in der Spalte Typ im Ereignisanzeige für ein Protokoll angegeben. Dieser Parameter gibt an, ob der Ereignistyp Fehler, Warnung, Informationen, Erfolgsüberwachung oder Fehlerüberwachung ist.

Sie müssen die Ereignisquelle erstellen und konfigurieren, bevor Sie den ersten Eintrag mit der Quelle schreiben. Create die neue Ereignisquelle während der Installation Ihrer Anwendung. Dadurch kann das Betriebssystem die Liste der registrierten Ereignisquellen und deren Konfiguration aktualisieren. Wenn das Betriebssystem die Liste der Ereignisquellen nicht aktualisiert hat und Sie versuchen, ein Ereignis mit der neuen Quelle zu schreiben, schlägt der Schreibvorgang fehl. Sie können eine neue Quelle mit oder EventLogInstallermit der CreateEventSource -Methode konfigurieren. Sie müssen über Administratorrechte auf dem Computer verfügen, um eine neue Ereignisquelle erstellen zu können.

Die Quelle muss entweder zum Schreiben lokalisierter Einträge oder zum Schreiben direkter Zeichenfolgen konfiguriert werden. Die WriteEntry -Methode schreibt die angegebene Zeichenfolge direkt in das Ereignisprotokoll und verwendet keine lokalisierbare Nachrichtenressourcendatei. Verwenden Sie die WriteEvent -Methode, um Ereignisse mithilfe einer lokalisierten Nachrichtenressourcendatei zu schreiben.

Wenn Ihre Anwendung Einträge mit Ressourcenbezeichnern und Zeichenfolgenwerten schreibt, müssen Sie zwei separate Quellen registrieren. Konfigurieren Sie beispielsweise eine Quelle mit Ressourcendateien, und verwenden Sie diese Quelle dann in der WriteEvent -Methode, um Einträge mithilfe von Ressourcenbezeichnern in das Ereignisprotokoll zu schreiben. Erstellen Sie dann eine andere Quelle ohne Ressourcendateien, und verwenden Sie diese Quelle in der WriteEntry -Methode, um Zeichenfolgen mithilfe dieser Quelle direkt in das Ereignisprotokoll zu schreiben.

Weitere Informationen

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

Quelle:

EventLog.cs

Quelle:

EventLog.cs

Quelle:

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)

Parameter

Ausnahmen

Beispiele

// 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)

Hinweise

Verwenden Sie diese Methode, um einen Eintrag mit einer Anwendung zu schreiben, die in das Ereignisprotokoll definiert category ist. Die Ereignisanzeige verwendet die Kategorie, um von einer Ereignisquelle geschriebene Ereignisse zu filtern. Die Ereignisanzeige kann die Kategorie als numerischen Wert anzeigen oder die Kategorie als Ressourcenbezeichner verwenden, um eine lokalisierte Kategoriezeichenfolge anzuzeigen.

Um lokalisierte Kategoriezeichenfolgen im Ereignisanzeige anzuzeigen, müssen Sie eine Ereignisquelle verwenden, die mit einer Kategorieressourcendatei konfiguriert ist, und legen Sie in category der Kategorieressourcendatei auf einen Ressourcenbezeichner fest. Wenn die Ereignisquelle über keine konfigurierte Kategorieressourcendatei verfügt oder die angegebene category keine Zeichenfolge in der Kategorieressourcendatei indiziert, zeigt die Ereignisanzeige den numerischen Kategoriewert für diesen Eintrag an. Konfigurieren Sie die Kategorieressourcendatei zusammen mit der Anzahl der Kategoriezeichenfolgen in der Ressourcendatei mithilfe der EventLogInstaller - oder - EventSourceCreationData Klasse.

Zusätzlich zur Kategorie können Sie einen Ereignisbezeichner für das Ereignis angeben, das in das Ereignisprotokoll geschrieben wird. Ereignisbezeichner identifizieren zusammen mit der Ereignisquelle ein Ereignis eindeutig. Jede Anwendung kann eigene nummerierte Ereignisse und die Beschreibungszeichenfolgen definieren, denen sie zugeordnet sind. Ereignisanzeigen zeigen diese Zeichenfolgenwerte an, um dem Benutzer zu helfen, zu verstehen, was falsch gelaufen ist, und schlägt vor, welche Aktionen ausgeführt werden sollen.

Schließlich können Sie eine EventLogEntryType für das Ereignis angeben, das in das Ereignisprotokoll geschrieben wird. Wird type durch ein Symbol und Text in der Spalte Typ im Ereignisanzeige für ein Protokoll angegeben. Dieser Parameter gibt an, ob der Ereignistyp Fehler, Warnung, Informationen, Erfolgsüberwachung oder Fehlerüberwachung ist.

Sie müssen die Source -Eigenschaft für Ihre EventLog Komponente festlegen, bevor Sie Einträge in das Protokoll schreiben können. Sie müssen die Ereignisquelle erstellen und konfigurieren, bevor Sie den ersten Eintrag mit der Quelle schreiben.

Create die neue Ereignisquelle während der Installation Ihrer Anwendung. Dadurch kann das Betriebssystem die Liste der registrierten Ereignisquellen und deren Konfiguration aktualisieren. Wenn das Betriebssystem die Liste der Ereignisquellen nicht aktualisiert hat und Sie versuchen, ein Ereignis mit der neuen Quelle zu schreiben, schlägt der Schreibvorgang fehl. Sie können eine neue Quelle mit oder EventLogInstallermit der CreateEventSource -Methode konfigurieren. Sie müssen über Administratorrechte auf dem Computer verfügen, um eine neue Ereignisquelle erstellen zu können.

Wenn die in der Source -Eigenschaft dieses EventLog instance angegebene Quelle nicht auf dem Computer registriert ist, auf den Ihre Komponente schreibt, ruft die Quelle auf CreateEventSource und WriteEntry registriert sie.

Wenn das System die Source über einen Aufruf WriteEntry von registrieren muss und die Log -Eigenschaft nicht auf Ihrem EventLog instance festgelegt wurde, wird standardmäßig das Anwendungsprotokoll verwendet.

Die Quelle muss entweder zum Schreiben lokalisierter Einträge oder zum Schreiben direkter Zeichenfolgen konfiguriert werden. Die WriteEntry -Methode schreibt die angegebene Zeichenfolge direkt in das Ereignisprotokoll und verwendet keine lokalisierbare Nachrichtenressourcendatei. Verwenden Sie die WriteEvent -Methode, um Ereignisse mithilfe einer lokalisierten Nachrichtenressourcendatei zu schreiben.

Wenn Ihre Anwendung Einträge mit Ressourcenbezeichnern und Zeichenfolgenwerten schreibt, müssen Sie zwei separate Quellen registrieren. Konfigurieren Sie beispielsweise eine Quelle mit Ressourcendateien, und verwenden Sie diese Quelle in der WriteEvent -Methode, um Einträge mithilfe von Ressourcenbezeichnern in das Ereignisprotokoll zu schreiben. Erstellen Sie dann eine andere Quelle ohne Ressourcendateien, und verwenden Sie diese Quelle in der WriteEntry -Methode, um Zeichenfolgen mithilfe dieser Quelle direkt in das Ereignisprotokoll zu schreiben.

Weitere Informationen

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

Quelle:

EventLog.cs

Quelle:

EventLog.cs

Quelle:

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)

Parameter

Ausnahmen

Beispiele

Im folgenden Beispiel wird auf dem lokalen Computer ein Warnungseintrag in das Ereignisprotokoll "MyNewLog" geschrieben.

#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

Hinweise

Verwenden Sie diese Methode, um einen Eintrag eines angegebenen EventLogEntryType in das Ereignisprotokoll zu schreiben. Die type wird durch ein Symbol und Text in der Spalte Typ im Ereignisanzeige für ein Protokoll angezeigt.

Sie müssen die Source -Eigenschaft für Ihre EventLog Komponente festlegen, bevor Sie Einträge in das Protokoll schreiben können. Sie müssen die Ereignisquelle erstellen und konfigurieren, bevor Sie den ersten Eintrag mit der Quelle schreiben.

Create die neue Ereignisquelle während der Installation Ihrer Anwendung. Dadurch kann das Betriebssystem die Liste der registrierten Ereignisquellen und deren Konfiguration aktualisieren. Wenn das Betriebssystem seine Liste der Ereignisquellen nicht aktualisiert hat und Sie versuchen, ein Ereignis mit der neuen Quelle zu schreiben, schlägt der Schreibvorgang fehl. Sie können eine neue Quelle mit oder EventLogInstallermit der CreateEventSource -Methode konfigurieren. Sie müssen über Administratorrechte auf dem Computer verfügen, um eine neue Ereignisquelle zu erstellen.

Wenn die in der Source Eigenschaft dieses EventLog instance angegebene Quelle nicht auf dem Computer registriert ist, auf den Ihre Komponente schreibt, WriteEntry ruft die Quelle auf CreateEventSource und registriert sie.

Wenn das System die Source über einen Aufruf WriteEntry von registrieren muss und die Log Eigenschaft nicht auf Ihrem EventLog instance festgelegt wurde, wird das Protokoll standardmäßig auf das Anwendungsprotokoll festgelegt.

Die Quelle muss entweder für das Schreiben lokalisierter Einträge oder für das Schreiben direkter Zeichenfolgen konfiguriert werden. Die WriteEntry -Methode schreibt die angegebene Zeichenfolge direkt in das Ereignisprotokoll und verwendet keine lokalisierbare Nachrichtenressourcendatei. Verwenden Sie die WriteEvent -Methode, um Ereignisse mithilfe einer lokalisierten Nachrichtenressourcendatei zu schreiben.

Wenn Ihre Anwendung Einträge mit Ressourcenbezeichnern und Zeichenfolgenwerten schreibt, müssen Sie zwei separate Quellen registrieren. Konfigurieren Sie beispielsweise eine Quelle mit Ressourcendateien, und verwenden Sie diese Quelle in der WriteEvent -Methode, um Einträge mithilfe von Ressourcenbezeichnern in das Ereignisprotokoll zu schreiben. Erstellen Sie dann eine andere Quelle ohne Ressourcendateien, und verwenden Sie diese Quelle in der WriteEntry -Methode, um Zeichenfolgen mithilfe dieser Quelle direkt in das Ereignisprotokoll zu schreiben.

Weitere Informationen

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

Quelle:

EventLog.cs

Quelle:

EventLog.cs

Quelle:

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)

Parameter

Ausnahmen

Beispiele

// 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)

Hinweise

Verwenden Sie diese Methode, um einen Eintrag mit einer Anwendung zu schreiben, die in das Ereignisprotokoll definiert eventID ist. Identifizieren Sie eventID zusammen mit der Quelle eindeutig ein Ereignis. Jede Anwendung kann ihre eigenen nummerierten Ereignisse und die Beschreibungszeichenfolgen definieren, denen sie zugeordnet werden. Ereignisanzeigen zeigen diese Zeichenfolgenwerte an, um dem Benutzer zu helfen, zu verstehen, was schief gelaufen ist, und schlägt vor, welche Aktionen ausgeführt werden sollen.

Zusätzlich zum Ereignisbezeichner können Sie eine EventLogEntryType für das Ereignis angeben, das in das Ereignisprotokoll geschrieben wird. Die type wird durch ein Symbol und Text in der Spalte Typ im Ereignisanzeige für ein Protokoll angezeigt. Dieser Parameter gibt an, ob der Ereignistyp Fehler, Warnung, Informationen, Erfolgsüberwachung oder Fehlerüberwachung ist.

Sie müssen die Source -Eigenschaft für Ihre EventLog Komponente festlegen, bevor Sie Einträge in das Protokoll schreiben können. Sie müssen die Ereignisquelle erstellen und konfigurieren, bevor Sie den ersten Eintrag mit der Quelle schreiben.

Create die neue Ereignisquelle während der Installation Ihrer Anwendung. Dadurch kann das Betriebssystem die Liste der registrierten Ereignisquellen und deren Konfiguration aktualisieren. Wenn das Betriebssystem seine Liste der Ereignisquellen nicht aktualisiert hat und Sie versuchen, ein Ereignis mit der neuen Quelle zu schreiben, schlägt der Schreibvorgang fehl. Sie können eine neue Quelle mit oder EventLogInstallermit der CreateEventSource -Methode konfigurieren. Sie müssen über Administratorrechte auf dem Computer verfügen, um eine neue Ereignisquelle zu erstellen.

Wenn die in der Source Eigenschaft dieses EventLog instance angegebene Quelle nicht auf dem Computer registriert ist, auf den Ihre Komponente schreibt, WriteEntry ruft die Quelle auf CreateEventSource und registriert sie.

Wenn das System die Source über einen Aufruf WriteEntry von registrieren muss und die Log Eigenschaft nicht auf Ihrem EventLog instance festgelegt wurde, wird das Protokoll standardmäßig auf das Anwendungsprotokoll festgelegt.

Die Quelle muss entweder für das Schreiben lokalisierter Einträge oder für das Schreiben direkter Zeichenfolgen konfiguriert werden. Die WriteEntry -Methode schreibt die angegebene Zeichenfolge direkt in das Ereignisprotokoll und verwendet keine lokalisierbare Nachrichtenressourcendatei. Verwenden Sie die WriteEvent -Methode, um Ereignisse mithilfe einer lokalisierten Nachrichtenressourcendatei zu schreiben.

Wenn Ihre Anwendung Einträge mit Ressourcenbezeichnern und Zeichenfolgenwerten schreibt, müssen Sie zwei separate Quellen registrieren. Konfigurieren Sie beispielsweise eine Quelle mit Ressourcendateien, und verwenden Sie diese Quelle in der WriteEvent -Methode, um Einträge mithilfe von Ressourcenbezeichnern in das Ereignisprotokoll zu schreiben. Erstellen Sie dann eine andere Quelle ohne Ressourcendateien, und verwenden Sie diese Quelle in der WriteEntry -Methode, um Zeichenfolgen mithilfe dieser Quelle direkt in das Ereignisprotokoll zu schreiben.

Weitere Informationen

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

Quelle:

EventLog.cs

Quelle:

EventLog.cs

Quelle:

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)

Parameter

Ausnahmen

Beispiele

Im folgenden Beispiel wird die Quelle MySource erstellt, sofern sie noch nicht vorhanden ist, und schreibt einen Eintrag in das Ereignisprotokoll 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

Hinweise

Verwenden Sie diese Methode, um einen Informationseintrag in das Ereignisprotokoll zu schreiben, wobei eine Quelle verwendet wird, die bereits als Ereignisquelle für das entsprechende Protokoll registriert ist. Wenn Sie eine andere EventLogEntryTypeangeben möchten, verwenden Sie eine andere Überladung von WriteEntry.

Sie müssen die Ereignisquelle erstellen und konfigurieren, bevor Sie den ersten Eintrag mit der Quelle schreiben. Create die neue Ereignisquelle während der Installation Ihrer Anwendung. Dadurch kann das Betriebssystem die Liste der registrierten Ereignisquellen und deren Konfiguration aktualisieren. Wenn das Betriebssystem die Liste der Ereignisquellen nicht aktualisiert hat und Sie versuchen, ein Ereignis mit der neuen Quelle zu schreiben, schlägt der Schreibvorgang fehl. Sie können eine neue Quelle mit oder EventLogInstallermit der CreateEventSource -Methode konfigurieren. Sie müssen über Administratorrechte auf dem Computer verfügen, um eine neue Ereignisquelle erstellen zu können.

Die Quelle muss entweder zum Schreiben lokalisierter Einträge oder zum Schreiben direkter Zeichenfolgen konfiguriert werden. Die WriteEntry -Methode schreibt die angegebene Zeichenfolge direkt in das Ereignisprotokoll und verwendet keine lokalisierbare Nachrichtenressourcendatei. Verwenden Sie die WriteEvent -Methode, um Ereignisse mithilfe einer lokalisierten Nachrichtenressourcendatei zu schreiben.

Wenn Ihre Anwendung Einträge mit Ressourcenbezeichnern und Zeichenfolgenwerten schreibt, müssen Sie zwei separate Quellen registrieren. Konfigurieren Sie beispielsweise eine Quelle mit Ressourcendateien, und verwenden Sie diese Quelle dann in der WriteEvent -Methode, um Einträge mithilfe von Ressourcenbezeichnern in das Ereignisprotokoll zu schreiben. Erstellen Sie dann eine andere Quelle ohne Ressourcendateien, und verwenden Sie diese Quelle in der WriteEntry -Methode, um Zeichenfolgen mithilfe dieser Quelle direkt in das Ereignisprotokoll zu schreiben.

Weitere Informationen

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

Quelle:

EventLog.cs

Quelle:

EventLog.cs

Quelle:

EventLog.cs

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

public void WriteEntry (string message);

member this.WriteEntry : string -> unit

Public Sub WriteEntry (message As String)

Parameter

Ausnahmen

Beispiele

Im folgenden Beispiel wird die Quelle MySource erstellt, sofern sie noch nicht vorhanden ist, und schreibt einen Eintrag in das Ereignisprotokoll 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

Hinweise

Verwenden Sie diese Methode, um einen Informationseintrag in das Ereignisprotokoll zu schreiben, das diesem EventLog instance zugeordnet ist. Wenn Sie eine andere EventLogEntryTypeangeben möchten, verwenden Sie eine andere Überladung von WriteEntry.

Sie müssen die Source -Eigenschaft für Ihre EventLog Komponente festlegen, bevor Sie Einträge in das Protokoll schreiben können. Sie müssen die Ereignisquelle erstellen und konfigurieren, bevor Sie den ersten Eintrag mit der Quelle schreiben.

Create die neue Ereignisquelle während der Installation Ihrer Anwendung. Dadurch kann das Betriebssystem die Liste der registrierten Ereignisquellen und deren Konfiguration aktualisieren. Wenn das Betriebssystem die Liste der Ereignisquellen nicht aktualisiert hat und Sie versuchen, ein Ereignis mit der neuen Quelle zu schreiben, schlägt der Schreibvorgang fehl. Sie können eine neue Quelle mit oder EventLogInstallermit der CreateEventSource -Methode konfigurieren. Sie müssen über Administratorrechte auf dem Computer verfügen, um eine neue Ereignisquelle erstellen zu können.

Wenn die in der Source -Eigenschaft dieses EventLog instance angegebene Quelle nicht auf dem Computer registriert ist, auf den Ihre Komponente schreibt, ruft die Quelle auf CreateEventSource und WriteEntry registriert sie.

Wenn das System die Source über einen Aufruf WriteEntry von registrieren muss und die Log -Eigenschaft nicht auf Ihrem EventLog instance festgelegt wurde, wird standardmäßig das Anwendungsprotokoll verwendet.

Die Quelle muss entweder zum Schreiben lokalisierter Einträge oder zum Schreiben direkter Zeichenfolgen konfiguriert werden. Die WriteEntry -Methode schreibt die angegebene Zeichenfolge direkt in das Ereignisprotokoll und verwendet keine lokalisierbare Nachrichtenressourcendatei. Verwenden Sie die WriteEvent -Methode, um Ereignisse mithilfe einer lokalisierten Nachrichtenressourcendatei zu schreiben.

Wenn Ihre Anwendung Einträge mit Ressourcenbezeichnern und Zeichenfolgenwerten schreibt, müssen Sie zwei separate Quellen registrieren. Konfigurieren Sie beispielsweise eine Quelle mit Ressourcendateien, und verwenden Sie diese Quelle dann in der WriteEvent -Methode, um Einträge mithilfe von Ressourcenbezeichnern in das Ereignisprotokoll zu schreiben. Erstellen Sie dann eine andere Quelle ohne Ressourcendateien, und verwenden Sie diese Quelle in der WriteEntry -Methode, um Zeichenfolgen mithilfe dieser Quelle direkt in das Ereignisprotokoll zu schreiben.

Weitere Informationen

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

Quelle:

EventLog.cs

Quelle:

EventLog.cs

Quelle:

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)

Parameter

Ausnahmen

Beispiele

Im folgenden Beispiel wird ein Warnungseintrag in das Ereignisprotokoll "MyNewLog" auf dem lokalen Computer geschrieben.

#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

Hinweise

Verwenden Sie diese Methode, um einen Eintrag eines angegebenen EventLogEntryType in das Ereignisprotokoll zu schreiben, wobei eine Quelle verwendet wird, die bereits als Ereignisquelle für das entsprechende Protokoll registriert ist. Wird type durch ein Symbol und Text in der Spalte Typ im Ereignisanzeige für ein Protokoll angegeben.

Sie müssen die Ereignisquelle erstellen und konfigurieren, bevor Sie den ersten Eintrag mit der Quelle schreiben. Create die neue Ereignisquelle während der Installation Ihrer Anwendung. Dadurch kann das Betriebssystem die Liste der registrierten Ereignisquellen und deren Konfiguration aktualisieren. Wenn das Betriebssystem die Liste der Ereignisquellen nicht aktualisiert hat und Sie versuchen, ein Ereignis mit der neuen Quelle zu schreiben, schlägt der Schreibvorgang fehl. Sie können eine neue Quelle mit oder EventLogInstallermit der CreateEventSource -Methode konfigurieren. Sie müssen über Administratorrechte auf dem Computer verfügen, um eine neue Ereignisquelle erstellen zu können.

Die Quelle muss entweder zum Schreiben lokalisierter Einträge oder zum Schreiben direkter Zeichenfolgen konfiguriert werden. Die WriteEntry -Methode schreibt die angegebene Zeichenfolge direkt in das Ereignisprotokoll und verwendet keine lokalisierbare Nachrichtenressourcendatei. Verwenden Sie die WriteEvent -Methode, um Ereignisse mithilfe einer lokalisierten Nachrichtenressourcendatei zu schreiben.

Wenn Ihre Anwendung Einträge mit Ressourcenbezeichnern und Zeichenfolgenwerten schreibt, müssen Sie zwei separate Quellen registrieren. Konfigurieren Sie beispielsweise eine Quelle mit Ressourcendateien, und verwenden Sie diese Quelle dann in der WriteEvent -Methode, um Einträge mithilfe von Ressourcenbezeichnern in das Ereignisprotokoll zu schreiben. Erstellen Sie dann eine andere Quelle ohne Ressourcendateien, und verwenden Sie diese Quelle in der WriteEntry -Methode, um Zeichenfolgen mithilfe dieser Quelle direkt in das Ereignisprotokoll zu schreiben.

Weitere Informationen

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