Freigeben über


EventLog.WriteEntry Methode

Definition

Schreibt einen Eintrag in das Ereignisprotokoll.

Überlädt

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

Schreibt einen Eintrag mit dem angegebenen Meldungstext, dem von der Anwendung definierten Ereignisbezeichner und der Kategorie in das Ereignisprotokoll, wobei die angegebene registrierte Ereignisquelle verwendet wird, und fügt Binärdaten an die Meldung an.

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

Schreibt einen Eintrag mit dem angegebenen Meldungstext, dem von der Anwendung definierten Ereignisbezeichner und der Kategorie in das Ereignisprotokoll, wobei die angegebene registrierte Ereignisquelle verwendet wird. Anhand der category kann die Ereignisanzeige Ereignisse im Protokoll filtern.

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

Schreibt einen Eintrag mit dem angegebenen Meldungstext, dem von der Anwendung definierten Ereignisbezeichner und der Kategorie in das Ereignisprotokoll und fügt Binärdaten an die Meldung an.

WriteEntry(String, String, EventLogEntryType, Int32)

Schreibt einen Eintrag mit dem angegebenen Meldungstext und dem von der Anwendung definierten Ereignisbezeichner in das Ereignisprotokoll, wobei die angegebene registrierte Ereignisquelle verwendet wird.

WriteEntry(String, EventLogEntryType, Int32, Int16)

Schreibt einen Eintrag mit dem angegebenen Meldungstext, dem von der Anwendung definierten Ereignisbezeichner und der Kategorie in das Ereignisprotokoll.

WriteEntry(String, EventLogEntryType)

Schreibt einen Eintrag für einen Fehler, eine Warnung, eine Information, eine Erfolgs- oder Fehlerüberwachung mit dem angegebenen Meldungstext in das Ereignisprotokoll.

WriteEntry(String, EventLogEntryType, Int32)

Schreibt einen Eintrag mit dem angegebenen Meldungstext und dem von der Anwendung definierten Ereignisbezeichner in das Ereignisprotokoll.

WriteEntry(String, String)

Schreibt einen Eintrag vom Typ Information mit dem angegebenen Meldungstext in das Ereignisprotokoll, wobei die angegebene registrierte Ereignisquelle verwendet wird.

WriteEntry(String)

Schreibt einen Eintrag vom Typ Information mit dem angegebenen Meldungstext in das Ereignisprotokoll.

WriteEntry(String, String, EventLogEntryType)

Schreibt einen Eintrag für einen Fehler, eine Warnung, eine Information oder eine Erfolgs- oder Fehlerüberwachung mit dem angegebenen Meldungstext in das Ereignisprotokoll, wobei die angegebene registrierte Ereignisquelle verwendet wird.

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

Quelle:
EventLog.cs
Quelle:
EventLog.cs
Quelle:
EventLog.cs

Schreibt einen Eintrag mit dem angegebenen Meldungstext, dem von der Anwendung definierten Ereignisbezeichner und der Kategorie in das Ereignisprotokoll, wobei die angegebene registrierte Ereignisquelle verwendet wird, und fügt Binärdaten an die Meldung an.

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

source
String

Die Quelle, unter der die Anwendung auf dem angegebenen Computer registriert ist.

message
String

Die in das Ereignisprotokoll zu schreibende Zeichenfolge.

type
EventLogEntryType

Einer der EventLogEntryType-Werte.

eventID
Int32

Der anwendungsspezifische Bezeichner für das Ereignis.

category
Int16

Die der Meldung zugeordnete anwendungsspezifische Unterkategorie.

rawData
Byte[]

Ein Bytearray mit den dem Eintrag zugeordneten Binärdaten.

Ausnahmen

Der source-Wert ist eine leere Zeichenfolge ("").

- oder -

Der source-Wert ist null.

- oder -

eventID ist kleiner als null oder größer als UInt16.MaxValue.

- oder -

Die Meldungszeichenfolge ist länger als 31.839 Bytes (32.766 Bytes auf Windows-Betriebssystemen vor Windows Vista).

- oder -

Der Quellenname führt dazu, dass der Registrierungsschlüsselpfad länger als 254 Zeichen ist.

Der Registrierungsschlüssel für das Ereignisprotokoll konnte nicht geöffnet werden.

Das Betriebssystem hat beim Schreiben des Ereigniseintrags in das Ereignisprotokoll einen Fehler gemeldet. Es ist kein Windows-Fehlercode verfügbar.

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.

Hinweis

Der category Parameter sollte ein positiver Wert sein. Negative Kategoriewerte werden als ergänzende positive Zahl im Ereignisanzeige angezeigt. Beispielsweise wird eine -10 als 65.526 und -1 als 65.535 angezeigt.

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.

Hinweis

Wenn der message Parameter ein NUL-Zeichen enthält, wird die Nachricht im Ereignisprotokoll am NUL-Zeichen beendet.

Die message Zeichenfolge kann nicht %n enthalten, wobei n ein ganzzahliger Wert ist (z. B. %1), da die Ereignisanzeige ihn als Einfügezeichenfolge behandelt. Da eine IPv6-Adresse (Internet Protocol, Version 6) diese Zeichenfolge enthalten kann, können Sie keine Ereignismeldung protokollieren, die eine IPv6-Adresse enthält.

Weitere Informationen

Gilt für:

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

Quelle:
EventLog.cs
Quelle:
EventLog.cs
Quelle:
EventLog.cs

Schreibt einen Eintrag mit dem angegebenen Meldungstext, dem von der Anwendung definierten Ereignisbezeichner und der Kategorie in das Ereignisprotokoll, wobei die angegebene registrierte Ereignisquelle verwendet wird. Anhand der category kann die Ereignisanzeige Ereignisse im Protokoll filtern.

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

source
String

Die Quelle, unter der die Anwendung auf dem angegebenen Computer registriert ist.

message
String

Die in das Ereignisprotokoll zu schreibende Zeichenfolge.

type
EventLogEntryType

Einer der EventLogEntryType-Werte.

eventID
Int32

Der anwendungsspezifische Bezeichner für das Ereignis.

category
Int16

Die der Meldung zugeordnete anwendungsspezifische Unterkategorie.

Ausnahmen

Der source-Wert ist eine leere Zeichenfolge ("").

- oder -

Der source-Wert ist null.

- oder -

eventID ist kleiner als null oder größer als UInt16.MaxValue.

- oder -

Die Meldungszeichenfolge ist länger als 31.839 Bytes (32.766 Bytes auf Windows-Betriebssystemen vor Windows Vista).

- oder -

Der Quellenname führt dazu, dass der Registrierungsschlüsselpfad länger als 254 Zeichen ist.

Der Registrierungsschlüssel für das Ereignisprotokoll konnte nicht geöffnet werden.

Das Betriebssystem hat beim Schreiben des Ereigniseintrags in das Ereignisprotokoll einen Fehler gemeldet. Es ist kein Windows-Fehlercode verfügbar.

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.

Hinweis

Der category Parameter sollte ein positiver Wert sein. Negative Kategoriewerte werden als ergänzende positive Zahl im Ereignisanzeige angezeigt. Beispielsweise wird -10 als 65.526 und -1 als 65.535 angezeigt.

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.

Hinweis

Wenn der message Parameter ein NUL-Zeichen enthält, wird die Nachricht im Ereignisprotokoll am NUL-Zeichen beendet.

Die message Zeichenfolge kann nicht %n enthalten, wobei n ein ganzzahliger Wert ist (z. B. %1), da die Ereignisanzeige ihn als Einfügezeichenfolge behandelt. Da eine IPv6-Adresse (Internet Protocol, Version 6) diese Zeichenfolge enthalten kann, können Sie keine Ereignismeldung protokollieren, die eine IPv6-Adresse enthält.

Weitere Informationen

Gilt für:

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

Quelle:
EventLog.cs
Quelle:
EventLog.cs
Quelle:
EventLog.cs

Schreibt einen Eintrag mit dem angegebenen Meldungstext, dem von der Anwendung definierten Ereignisbezeichner und der Kategorie in das Ereignisprotokoll und fügt Binärdaten an die Meldung an.

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

message
String

Die in das Ereignisprotokoll zu schreibende Zeichenfolge.

type
EventLogEntryType

Einer der EventLogEntryType-Werte.

eventID
Int32

Der anwendungsspezifische Bezeichner für das Ereignis.

category
Int16

Die der Meldung zugeordnete anwendungsspezifische Unterkategorie.

rawData
Byte[]

Ein Bytearray mit den dem Eintrag zugeordneten Binärdaten.

Ausnahmen

Die Source-Eigenschaft von EventLog wurde nicht festgelegt.

- oder -

Die Methode hat versucht, eine neue Ereignisquelle zu registrieren, der Computername in MachineName ist jedoch ungültig.

- oder -

Die Quelle ist bereits für ein anderes Ereignisprotokoll registriert.

- oder -

eventID ist kleiner als null oder größer als UInt16.MaxValue.

- oder -

Die Meldungszeichenfolge ist länger als 31.839 Bytes (32.766 Bytes auf Windows-Betriebssystemen vor Windows Vista).

- oder -

Der Quellenname führt dazu, dass der Registrierungsschlüsselpfad länger als 254 Zeichen ist.

Der Registrierungsschlüssel für das Ereignisprotokoll konnte nicht geöffnet werden.

Das Betriebssystem hat beim Schreiben des Ereigniseintrags in das Ereignisprotokoll einen Fehler gemeldet. Es ist kein Windows-Fehlercode verfügbar.

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.

Hinweis

Die message Zeichenfolge kann nicht %n enthalten, wobei n ein ganzzahliger Wert ist (z. B. %1), da die Ereignisanzeige ihn als Einfügezeichenfolge behandelt. Da eine IPv6-Adresse (Internet Protocol, Version 6) diese Zeichenfolge enthalten kann, können Sie keine Ereignismeldung protokollieren, die eine IPv6-Adresse enthält.

Hinweis

Der category Parameter sollte ein positiver Wert sein. Negative Kategoriewerte werden als ergänzende positive Zahl im Ereignisanzeige angezeigt. Beispielsweise wird -10 als 65.526 und -1 als 65.535 angezeigt.

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.

Hinweis

Wenn Sie keinen für Ihre instance angebenMachineName, bevor Sie oder WriteEntryaufrufenCreateEventSource, wird der lokale Computer (".") EventLog angenommen.

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.

Hinweis

Viele oben aufgeführte Ausnahmen werden durch Fehler generiert, die beim Registrieren von Sourceausgelöst werden.

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.

Hinweis

Wenn Sie einen Eintrag auf einen Remotecomputer schreiben, entspricht der Wert der Nachricht (die Textzeichenfolge) möglicherweise nicht den Erwartungen, wenn auf dem Remotecomputer die .NET Framework nicht ausgeführt wird.

Hinweis

Wenn der message Parameter ein NUL-Zeichen enthält, wird die Nachricht im Ereignisprotokoll am NUL-Zeichen beendet.

Weitere Informationen

Gilt für:

WriteEntry(String, String, EventLogEntryType, Int32)

Quelle:
EventLog.cs
Quelle:
EventLog.cs
Quelle:
EventLog.cs

Schreibt einen Eintrag mit dem angegebenen Meldungstext und dem von der Anwendung definierten Ereignisbezeichner in das Ereignisprotokoll, wobei die angegebene registrierte Ereignisquelle verwendet wird.

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

source
String

Die Quelle, unter der die Anwendung auf dem angegebenen Computer registriert ist.

message
String

Die in das Ereignisprotokoll zu schreibende Zeichenfolge.

type
EventLogEntryType

Einer der EventLogEntryType-Werte.

eventID
Int32

Der anwendungsspezifische Bezeichner für das Ereignis.

Ausnahmen

Der source-Wert ist eine leere Zeichenfolge ("").

- oder -

Der source-Wert ist null.

- oder -

eventID ist kleiner als null oder größer als UInt16.MaxValue.

- oder -

Die Meldungszeichenfolge ist länger als 31.839 Bytes (32.766 Bytes auf Windows-Betriebssystemen vor Windows Vista).

- oder -

Der Quellenname führt dazu, dass der Registrierungsschlüsselpfad länger als 254 Zeichen ist.

Der Registrierungsschlüssel für das Ereignisprotokoll konnte nicht geöffnet werden.

Das Betriebssystem hat beim Schreiben des Ereigniseintrags in das Ereignisprotokoll einen Fehler gemeldet. Es ist kein Windows-Fehlercode verfügbar.

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.

Hinweis

Die message Zeichenfolge kann nicht %n enthalten, wobei n ein ganzzahliger Wert ist (z. B. %1), da die Ereignisanzeige ihn als Einfügezeichenfolge behandelt. Da eine IPv6-Adresse (Internet Protocol, Version 6) diese Zeichenfolge enthalten kann, können Sie keine Ereignismeldung protokollieren, die eine IPv6-Adresse enthält.

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.

Hinweis

Wenn der message Parameter ein NUL-Zeichen enthält, wird die Nachricht im Ereignisprotokoll am NUL-Zeichen beendet.

Weitere Informationen

Gilt für:

WriteEntry(String, EventLogEntryType, Int32, Int16)

Quelle:
EventLog.cs
Quelle:
EventLog.cs
Quelle:
EventLog.cs

Schreibt einen Eintrag mit dem angegebenen Meldungstext, dem von der Anwendung definierten Ereignisbezeichner und der Kategorie in das Ereignisprotokoll.

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

message
String

Die in das Ereignisprotokoll zu schreibende Zeichenfolge.

type
EventLogEntryType

Einer der EventLogEntryType-Werte.

eventID
Int32

Der anwendungsspezifische Bezeichner für das Ereignis.

category
Int16

Die der Meldung zugeordnete anwendungsspezifische Unterkategorie.

Ausnahmen

Die Source-Eigenschaft von EventLog wurde nicht festgelegt.

- oder -

Die Methode hat versucht, eine neue Ereignisquelle zu registrieren, der Computername in MachineName ist jedoch ungültig.

- oder -

Die Quelle ist bereits für ein anderes Ereignisprotokoll registriert.

- oder -

eventID ist kleiner als null oder größer als UInt16.MaxValue.

- oder -

Die Meldungszeichenfolge ist länger als 31.839 Bytes (32.766 Bytes auf Windows-Betriebssystemen vor Windows Vista).

- oder -

Der Quellenname führt dazu, dass der Registrierungsschlüsselpfad länger als 254 Zeichen ist.

Der Registrierungsschlüssel für das Ereignisprotokoll konnte nicht geöffnet werden.

Das Betriebssystem hat beim Schreiben des Ereigniseintrags in das Ereignisprotokoll einen Fehler gemeldet. Es ist kein Windows-Fehlercode verfügbar.

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.

Hinweis

Der category Parameter sollte ein positiver Wert sein. Negative Kategoriewerte werden als ergänzende positive Zahl im Ereignisanzeige angezeigt. Beispielsweise wird -10 als 65.526 und -1 als 65.535 angezeigt.

Hinweis

Die message Zeichenfolge kann nicht %n enthalten, wobei n ein ganzzahliger Wert ist (z. B. %1), da die Ereignisanzeige ihn als Einfügezeichenfolge behandelt. Da eine IPv6-Adresse (Internet Protocol, Version 6) diese Zeichenfolge enthalten kann, können Sie keine Ereignismeldung protokollieren, die eine IPv6-Adresse enthält.

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.

Hinweis

Wenn Sie keinen für Ihre instance angebenMachineName, bevor Sie oder WriteEntryaufrufenCreateEventSource, wird der lokale Computer (".") EventLog angenommen.

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.

Hinweis

Viele oben aufgeführte Ausnahmen werden durch Fehler generiert, die beim Registrieren von Sourceausgelöst werden.

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.

Hinweis

Wenn Sie einen Eintrag auf einen Remotecomputer schreiben, ist der Wert der Nachricht (die Textzeichenfolge) möglicherweise nicht der, den Sie erwarten, wenn der Remotecomputer die .NET Framework nicht ausführt.

Hinweis

Wenn der message Parameter ein NUL-Zeichen enthält, wird die Nachricht im Ereignisprotokoll am NUL-Zeichen beendet.

Weitere Informationen

Gilt für:

WriteEntry(String, EventLogEntryType)

Quelle:
EventLog.cs
Quelle:
EventLog.cs
Quelle:
EventLog.cs

Schreibt einen Eintrag für einen Fehler, eine Warnung, eine Information, eine Erfolgs- oder Fehlerüberwachung mit dem angegebenen Meldungstext in das Ereignisprotokoll.

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

message
String

Die in das Ereignisprotokoll zu schreibende Zeichenfolge.

type
EventLogEntryType

Einer der EventLogEntryType-Werte.

Ausnahmen

Die Source-Eigenschaft von EventLog wurde nicht festgelegt.

- oder -

Die Methode hat versucht, eine neue Ereignisquelle zu registrieren, der Computername in MachineName ist jedoch ungültig.

- oder -

Die Quelle ist bereits für ein anderes Ereignisprotokoll registriert.

- oder -

Die Meldungszeichenfolge ist länger als 31.839 Bytes (32.766 Bytes auf Windows-Betriebssystemen vor Windows Vista).

- oder -

Der Quellenname führt dazu, dass der Registrierungsschlüsselpfad länger als 254 Zeichen ist.

Der Registrierungsschlüssel für das Ereignisprotokoll konnte nicht geöffnet werden.

Das Betriebssystem hat beim Schreiben des Ereigniseintrags in das Ereignisprotokoll einen Fehler gemeldet. Es ist kein Windows-Fehlercode verfügbar.

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.

Hinweis

Die message Zeichenfolge kann %n nicht enthalten, wobei n ein ganzzahliger Wert ist (z. B. %1), da die Ereignisanzeige sie als Einfügezeichenfolge behandelt. Da eine IPv6-Adresse (Internet Protocol, Version 6) diese Zeichenfolge enthalten kann, können Sie keine Ereignismeldung protokollieren, die eine IPv6-Adresse enthält.

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.

Hinweis

Wenn Sie keinen für Ihre instance angebenMachineName, bevor Sie oder aufrufenCreateEventSource, WriteEntrywird der lokale Computer (".") EventLog angenommen.

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.

Hinweis

Viele oben aufgeführte Ausnahmen werden durch Fehler generiert, die beim Registrieren von Sourceausgelöst werden.

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.

Hinweis

Wenn Sie einen Eintrag auf einen Remotecomputer schreiben, ist der Wert der Nachricht (die Textzeichenfolge) möglicherweise nicht der, den Sie erwarten, wenn der Remotecomputer die .NET Framework nicht ausführt.

Hinweis

Wenn der message Parameter ein NUL-Zeichen enthält, wird die Nachricht im Ereignisprotokoll am NUL-Zeichen beendet.

Weitere Informationen

Gilt für:

WriteEntry(String, EventLogEntryType, Int32)

Quelle:
EventLog.cs
Quelle:
EventLog.cs
Quelle:
EventLog.cs

Schreibt einen Eintrag mit dem angegebenen Meldungstext und dem von der Anwendung definierten Ereignisbezeichner in das Ereignisprotokoll.

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

message
String

Die in das Ereignisprotokoll zu schreibende Zeichenfolge.

type
EventLogEntryType

Einer der EventLogEntryType-Werte.

eventID
Int32

Der anwendungsspezifische Bezeichner für das Ereignis.

Ausnahmen

Die Source-Eigenschaft von EventLog wurde nicht festgelegt.

- oder -

Die Methode hat versucht, eine neue Ereignisquelle zu registrieren, der Computername in MachineName ist jedoch ungültig.

- oder -

Die Quelle ist bereits für ein anderes Ereignisprotokoll registriert.

- oder -

eventID ist kleiner als 0 oder größer als UInt16.MaxValue.

- oder -

Die Meldungszeichenfolge ist länger als 31.839 Bytes (32.766 Bytes auf Windows-Betriebssystemen vor Windows Vista).

- oder -

Der Quellenname führt dazu, dass der Registrierungsschlüsselpfad länger als 254 Zeichen ist.

Der Registrierungsschlüssel für das Ereignisprotokoll konnte nicht geöffnet werden.

Das Betriebssystem hat beim Schreiben des Ereigniseintrags in das Ereignisprotokoll einen Fehler gemeldet. Es ist kein Windows-Fehlercode verfügbar.

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.

Hinweis

Die message Zeichenfolge kann %n nicht enthalten, wobei n ein ganzzahliger Wert ist (z. B. %1), da die Ereignisanzeige sie als Einfügezeichenfolge behandelt. Da eine IPv6-Adresse (Internet Protocol, Version 6) diese Zeichenfolge enthalten kann, können Sie keine Ereignismeldung protokollieren, die eine IPv6-Adresse enthält.

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.

Hinweis

Wenn Sie keinen für Ihre instance angebenMachineName, bevor Sie oder aufrufenCreateEventSource, WriteEntrywird der lokale Computer (".") EventLog angenommen.

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.

Hinweis

Viele oben aufgeführte Ausnahmen werden durch Fehler generiert, die beim Registrieren von Sourceausgelöst werden.

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.

Hinweis

Wenn Sie einen Eintrag auf einen Remotecomputer schreiben, entspricht der Wert der Nachricht (die Textzeichenfolge) möglicherweise nicht den Erwartungen, wenn auf dem Remotecomputer die .NET Framework nicht ausgeführt wird.

Hinweis

Wenn der message Parameter ein NUL-Zeichen enthält, wird die Nachricht im Ereignisprotokoll am NUL-Zeichen beendet.

Weitere Informationen

Gilt für:

WriteEntry(String, String)

Quelle:
EventLog.cs
Quelle:
EventLog.cs
Quelle:
EventLog.cs

Schreibt einen Eintrag vom Typ Information mit dem angegebenen Meldungstext in das Ereignisprotokoll, wobei die angegebene registrierte Ereignisquelle verwendet wird.

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

source
String

Die Quelle, unter der die Anwendung auf dem angegebenen Computer registriert ist.

message
String

Die in das Ereignisprotokoll zu schreibende Zeichenfolge.

Ausnahmen

Der source-Wert ist eine leere Zeichenfolge ("").

- oder -

Der source-Wert ist null.

- oder -

Die Meldungszeichenfolge ist länger als 31.839 Bytes (32.766 Bytes auf Windows-Betriebssystemen vor Windows Vista).

- oder -

Der Quellenname führt dazu, dass der Registrierungsschlüsselpfad länger als 254 Zeichen ist.

Der Registrierungsschlüssel für das Ereignisprotokoll konnte nicht geöffnet werden.

Das Betriebssystem hat beim Schreiben des Ereigniseintrags in das Ereignisprotokoll einen Fehler gemeldet. Es ist kein Windows-Fehlercode verfügbar.

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.

Hinweis

Wenn der message Parameter ein NUL-Zeichen enthält, wird die Nachricht im Ereignisprotokoll am NUL-Zeichen beendet.

Die message Zeichenfolge kann nicht %n enthalten, wobei n ein ganzzahliger Wert ist (z. B. %1), da die Ereignisanzeige ihn als Einfügezeichenfolge behandelt. Da eine IPv6-Adresse (Internet Protocol, Version 6) diese Zeichenfolge enthalten kann, können Sie keine Ereignismeldung protokollieren, die eine IPv6-Adresse enthält.

Weitere Informationen

Gilt für:

WriteEntry(String)

Quelle:
EventLog.cs
Quelle:
EventLog.cs
Quelle:
EventLog.cs

Schreibt einen Eintrag vom Typ Information mit dem angegebenen Meldungstext in das Ereignisprotokoll.

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

Parameter

message
String

Die in das Ereignisprotokoll zu schreibende Zeichenfolge.

Ausnahmen

Die Source-Eigenschaft von EventLog wurde nicht festgelegt.

- oder -

Die Methode hat versucht, eine neue Ereignisquelle zu registrieren, der Computername in MachineName ist jedoch ungültig.

- oder -

Die Quelle ist bereits für ein anderes Ereignisprotokoll registriert.

- oder -

Die Meldungszeichenfolge ist länger als 31.839 Bytes (32.766 Bytes auf Windows-Betriebssystemen vor Windows Vista).

- oder -

Der Quellenname führt dazu, dass der Registrierungsschlüsselpfad länger als 254 Zeichen ist.

Der Registrierungsschlüssel für das Ereignisprotokoll konnte nicht geöffnet werden.

Das Betriebssystem hat beim Schreiben des Ereigniseintrags in das Ereignisprotokoll einen Fehler gemeldet. Es ist kein Windows-Fehlercode verfügbar.

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.

Hinweis

Die message Zeichenfolge kann nicht %n enthalten, wobei n ein ganzzahliger Wert ist (z. B. %1), da die Ereignisanzeige ihn als Einfügezeichenfolge behandelt. Da eine IPv6-Adresse (Internet Protocol, Version 6) diese Zeichenfolge enthalten kann, können Sie keine Ereignismeldung protokollieren, die eine IPv6-Adresse enthält.

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.

Hinweis

Wenn Sie keinen für Ihre instance angebenMachineName, bevor Sie oder WriteEntryaufrufenCreateEventSource, wird der lokale Computer (".") EventLog angenommen.

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.

Hinweis

Viele der oben aufgeführten Ausnahmen werden durch Fehler generiert, die beim Registrieren von Sourceausgelöst werden.

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.

Hinweis

Wenn Sie einen Eintrag auf einen Remotecomputer schreiben, entspricht der Wert der Nachricht (die Textzeichenfolge) möglicherweise nicht den Erwartungen, wenn auf dem Remotecomputer die .NET Framework nicht ausgeführt wird.

Hinweis

Wenn der message Parameter ein NUL-Zeichen enthält, wird die Nachricht im Ereignisprotokoll am NUL-Zeichen beendet.

Weitere Informationen

Gilt für:

WriteEntry(String, String, EventLogEntryType)

Quelle:
EventLog.cs
Quelle:
EventLog.cs
Quelle:
EventLog.cs

Schreibt einen Eintrag für einen Fehler, eine Warnung, eine Information oder eine Erfolgs- oder Fehlerüberwachung mit dem angegebenen Meldungstext in das Ereignisprotokoll, wobei die angegebene registrierte Ereignisquelle verwendet wird.

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

source
String

Die Quelle, unter der die Anwendung auf dem angegebenen Computer registriert ist.

message
String

Die in das Ereignisprotokoll zu schreibende Zeichenfolge.

type
EventLogEntryType

Einer der EventLogEntryType-Werte.

Ausnahmen

Der source-Wert ist eine leere Zeichenfolge ("").

- oder -

Der source-Wert ist null.

- oder -

Die Meldungszeichenfolge ist länger als 31.839 Bytes (32.766 Bytes auf Windows-Betriebssystemen vor Windows Vista).

- oder -

Der Quellenname führt dazu, dass der Registrierungsschlüsselpfad länger als 254 Zeichen ist.

Der Registrierungsschlüssel für das Ereignisprotokoll konnte nicht geöffnet werden.

Das Betriebssystem hat beim Schreiben des Ereigniseintrags in das Ereignisprotokoll einen Fehler gemeldet. Es ist kein Windows-Fehlercode verfügbar.

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.

Hinweis

Die message Zeichenfolge kann nicht %n enthalten, wobei n ein ganzzahliger Wert ist (z. B. %1), da die Ereignisanzeige ihn als Einfügezeichenfolge behandelt. Da eine IPv6-Adresse (Internet Protocol, Version 6) diese Zeichenfolge enthalten kann, können Sie keine Ereignismeldung protokollieren, die eine IPv6-Adresse enthält.

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.

Hinweis

Wenn der message Parameter ein NUL-Zeichen enthält, wird die Nachricht im Ereignisprotokoll am NUL-Zeichen beendet.

Weitere Informationen

Gilt für: