EventLog.WriteEntry Methode

Quelle:

EventLog.cs

Quelle:

EventLog.cs

Quelle:

EventLog.cs

Quelle:

EventLog.cs

Quelle:

EventLog.cs

Quelle:

EventLog.cs

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.
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; Es zeigt Rohdaten nur in einem kombinierten Hexadezimal- und Textformat an. Verwenden Sie ereignisspezifische Daten sparsam; schließen 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 überprüft, und Berichte erstellt, die Informationen aus den ereignisspezifischen Daten enthalten.

Zusätzlich zu den Binärdaten können Sie eine anwendungsdefinierte Kategorie und einen anwendungsdefinierten Ereignisbezeichner angeben. Die Ereignisanzeige verwendet die Kategorie zum Filtern von Ereignissen, die von einer Ereignisquelle geschrieben wurden. Die Ereignisanzeige kann die Kategorie als numerischer Wert anzeigen oder die Kategorie als Ressourcenbezeichner verwenden, um eine lokalisierte Kategoriezeichenfolge anzuzeigen.

Um lokalisierte Kategoriezeichenfolgen in der Ereignisanzeige anzuzeigen, müssen Sie eine Ereignisquelle verwenden, die mit einer Kategorieressourcendatei konfiguriert ist, und den category Wert in der Kategorieressourcendatei auf einen Ressourcenbezeichner festlegen. Wenn die Ereignisquelle keine konfigurierte Kategorieressourcendatei aufweist oder die angegebene category Datei 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 EventLogInstaller der Klasse oder der 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 verstehen, was schief gelaufen ist, und schlägt vor, welche Aktionen ausgeführt werden sollen.

Schließlich können Sie ein EventLogEntryType Ereignis angeben, das in das Ereignisprotokoll geschrieben wird. Dies type wird durch ein Symbol und Text in der Spalte "Typ" in der 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. Erstellen Sie die neue Ereignisquelle während der Installation Ihrer Anwendung. Dadurch kann das Betriebssystem seine 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 mithilfe einer EventLogInstallerOder mithilfe der CreateEventSource Methode konfigurieren. Sie müssen über Administratorrechte auf dem Computer verfügen, um eine neue Ereignisquelle zu erstellen.

Die Quelle muss entweder für das Schreiben lokalisierter Einträge oder für das Schreiben von direkten Zeichenfolgen konfiguriert werden. Die WriteEntry Methode schreibt die angegebene Zeichenfolge direkt in das Ereignisprotokoll. Sie 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

Quelle:

EventLog.cs

Quelle:

EventLog.cs

Quelle:

EventLog.cs

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

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 einem anwendungsdefiniert category in das Ereignisprotokoll zu schreiben, wobei eine Quelle verwendet wird, die bereits als Ereignisquelle für das entsprechende Protokoll registriert ist. Die Ereignisanzeige verwendet die Kategorie zum Filtern von Ereignissen, die von einer Ereignisquelle geschrieben wurden. Die Ereignisanzeige kann die Kategorie als numerischer Wert anzeigen oder die Kategorie als Ressourcenbezeichner verwenden, um eine lokalisierte Kategoriezeichenfolge anzuzeigen.

Um lokalisierte Kategoriezeichenfolgen in der Ereignisanzeige anzuzeigen, müssen Sie eine Ereignisquelle verwenden, die mit einer Kategorieressourcendatei konfiguriert ist, und den category Wert in der Kategorieressourcendatei auf einen Ressourcenbezeichner festlegen. Wenn die Ereignisquelle keine konfigurierte Kategorieressourcendatei aufweist oder die angegebene category Datei 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 EventLogInstaller der Klasse oder der 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 verstehen, was schief gelaufen ist, und schlägt vor, welche Aktionen ausgeführt werden sollen.

Schließlich können Sie ein EventLogEntryType Ereignis angeben, das in das Ereignisprotokoll geschrieben wird. Dies type wird durch ein Symbol und Text in der Spalte "Typ" in der 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. Erstellen Sie die neue Ereignisquelle während der Installation Ihrer Anwendung. Dadurch kann das Betriebssystem seine 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 mithilfe einer EventLogInstallerOder mithilfe der CreateEventSource Methode konfigurieren. Sie müssen über Administratorrechte auf dem Computer verfügen, um eine neue Ereignisquelle zu erstellen.

Die Quelle muss entweder für das Schreiben lokalisierter Einträge oder für das Schreiben von direkten Zeichenfolgen konfiguriert werden. Die WriteEntry Methode schreibt die angegebene Zeichenfolge direkt in das Ereignisprotokoll. Sie 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

Quelle:

EventLog.cs

Quelle:

EventLog.cs

Quelle:

EventLog.cs

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"))
{
   // 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; Es zeigt Rohdaten nur in einem kombinierten Hexadezimal- und Textformat an. Verwenden Sie ereignisspezifische Daten sparsam, einschließlich nur, wenn Sie sicher sind, dass es für jemanden nützlich ist, der das Problem debuggen soll. 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 überprüft, und Berichte erstellt, die Informationen aus den ereignisspezifischen Daten enthalten.

Zusätzlich zu den Binärdaten können Sie eine anwendungsdefinierte Kategorie und einen anwendungsdefinierten Ereignisbezeichner angeben. Die Ereignisanzeige verwendet die Kategorie zum Filtern von Ereignissen, die von einer Ereignisquelle geschrieben wurden. Die Ereignisanzeige kann die Kategorie als numerischer Wert anzeigen oder die Kategorie als Ressourcenbezeichner verwenden, um eine lokalisierte Kategoriezeichenfolge anzuzeigen.

Um lokalisierte Kategoriezeichenfolgen in der Ereignisanzeige anzuzeigen, müssen Sie eine Ereignisquelle verwenden, die mit einer Kategorieressourcendatei konfiguriert ist, und den category Wert in der Kategorieressourcendatei auf einen Ressourcenbezeichner festlegen. Wenn die Ereignisquelle keine konfigurierte Kategorieressourcendatei aufweist oder die angegebene category Datei 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 EventLogInstaller der Klasse oder der 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 verstehen, was schief gelaufen ist, und schlägt vor, welche Aktionen ausgeführt werden sollen.

Schließlich können Sie ein EventLogEntryType Ereignis angeben, das in das Ereignisprotokoll geschrieben wird. Dies type wird durch ein Symbol und Text in der Spalte "Typ" in der 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.

Erstellen Sie die neue Ereignisquelle während der Installation Ihrer Anwendung. Dadurch kann das Betriebssystem seine 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 mithilfe einer EventLogInstallerOder mithilfe 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 dieser EventLog Instanz angegebene Quelle nicht auf dem Computer registriert ist, in den Ihre Komponente schreibt, ruft die Quelle auf CreateEventSource und WriteEntry registriert sie.

Wenn das System den Source Aufruf über einen Aufruf WriteEntry registrieren muss und die Log Eigenschaft für Ihre EventLog Instanz nicht festgelegt wurde, wird das Protokoll standardmäßig im Anwendungsprotokoll gespeichert.

Die Quelle muss entweder für das Schreiben lokalisierter Einträge oder für das Schreiben von direkten Zeichenfolgen konfiguriert werden. Die WriteEntry Methode schreibt die angegebene Zeichenfolge direkt in das Ereignisprotokoll. Sie 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

Quelle:

EventLog.cs

Quelle:

EventLog.cs

Quelle:

EventLog.cs

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"))
{
   // 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 einem anwendungsdefiniert eventID in das Ereignisprotokoll zu schreiben, wobei eine quelle, die bereits als Ereignisquelle für das entsprechende Protokoll registriert ist. Das eventID, zusammen mit der Quelle, identifiziert ein Ereignis eindeutig. Jede Anwendung kann eigene nummerierte Ereignisse und die Beschreibungszeichenfolgen definieren, denen sie zugeordnet sind. Ereignisanzeigen präsentieren diese Zeichenfolgen für den Benutzer, um dem Benutzer zu helfen, zu verstehen, was schief gelaufen ist, und schlägt vor, welche Aktionen ausgeführt werden sollen.

Zusätzlich zur Ereignis-ID können Sie mit dieser Überladung WriteEntry ein EventLogEntryType Ereignis angeben, das in das Ereignisprotokoll geschrieben wird. Dies type wird durch ein Symbol und Text in der Spalte "Typ" in der 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. Erstellen Sie die neue Ereignisquelle während der Installation Ihrer Anwendung. Dadurch kann das Betriebssystem seine 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 mithilfe einer EventLogInstallerOder mithilfe der CreateEventSource Methode konfigurieren. Sie müssen über Administratorrechte auf dem Computer verfügen, um eine neue Ereignisquelle zu erstellen.

Die Quelle muss entweder für das Schreiben lokalisierter Einträge oder für das Schreiben von direkten Zeichenfolgen konfiguriert werden. Die WriteEntry Methode schreibt die angegebene Zeichenfolge direkt in das Ereignisprotokoll. Sie 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

Quelle:

EventLog.cs

Quelle:

EventLog.cs

Quelle:

EventLog.cs

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 = 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 einem anwendungsdefiniert category in das Ereignisprotokoll zu schreiben. Die Ereignisanzeige verwendet die Kategorie zum Filtern von Ereignissen, die von einer Ereignisquelle geschrieben wurden. Die Ereignisanzeige kann die Kategorie als numerischer Wert anzeigen oder die Kategorie als Ressourcenbezeichner verwenden, um eine lokalisierte Kategoriezeichenfolge anzuzeigen.

Um lokalisierte Kategoriezeichenfolgen in der Ereignisanzeige anzuzeigen, müssen Sie eine Ereignisquelle verwenden, die mit einer Kategorieressourcendatei konfiguriert ist, und den category Wert in der Kategorieressourcendatei auf einen Ressourcenbezeichner festlegen. Wenn die Ereignisquelle keine konfigurierte Kategorieressourcendatei aufweist oder die angegebene category Datei 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 EventLogInstaller der Klasse oder der 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 verstehen, was schief gelaufen ist, und schlägt vor, welche Aktionen ausgeführt werden sollen.

Schließlich können Sie ein EventLogEntryType Ereignis angeben, das in das Ereignisprotokoll geschrieben wird. Dies type wird durch ein Symbol und Text in der Spalte "Typ" in der 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.

Erstellen Sie die neue Ereignisquelle während der Installation Ihrer Anwendung. Dadurch kann das Betriebssystem seine 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 mithilfe einer EventLogInstallerOder mithilfe 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 dieser EventLog Instanz angegebene Quelle nicht auf dem Computer registriert ist, in den Ihre Komponente schreibt, ruft die Quelle auf CreateEventSource und WriteEntry registriert sie.

Wenn das System den Source Aufruf über einen Aufruf WriteEntry registrieren muss und die Log Eigenschaft für Ihre EventLog Instanz nicht festgelegt wurde, wird das Protokoll standardmäßig im Anwendungsprotokoll gespeichert.

Die Quelle muss entweder für das Schreiben lokalisierter Einträge oder für das Schreiben von direkten Zeichenfolgen konfiguriert werden. Die WriteEntry Methode schreibt die angegebene Zeichenfolge direkt in das Ereignisprotokoll. Sie 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

Quelle:

EventLog.cs

Quelle:

EventLog.cs

Quelle:

EventLog.cs

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 ein Warneintrag in ein Ereignisprotokoll "MyNewLog" auf dem lokalen Computer geschrieben.

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 Eintrags in das Ereignisprotokoll zu schreiben. Dies type wird durch ein Symbol und Text in der Spalte "Typ" in der Ereignisanzeige für ein Protokoll angegeben.

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.

Erstellen Sie die neue Ereignisquelle während der Installation Ihrer Anwendung. Dadurch kann das Betriebssystem seine 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 mithilfe einer EventLogInstallerOder mithilfe 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 dieser EventLog Instanz angegebene Quelle nicht auf dem Computer registriert ist, in den Ihre Komponente schreibt, ruft die Quelle auf CreateEventSource und WriteEntry registriert sie.

Wenn das System den Source Aufruf über einen Aufruf WriteEntry registrieren muss und die Log Eigenschaft für Ihre EventLog Instanz nicht festgelegt wurde, wird das Protokoll standardmäßig im Anwendungsprotokoll gespeichert.

Die Quelle muss entweder für das Schreiben lokalisierter Einträge oder für das Schreiben von direkten Zeichenfolgen konfiguriert werden. Die WriteEntry Methode schreibt die angegebene Zeichenfolge direkt in das Ereignisprotokoll. Sie 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

Quelle:

EventLog.cs

Quelle:

EventLog.cs

Quelle:

EventLog.cs

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 = 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 einem anwendungsdefiniert eventID in das Ereignisprotokoll zu schreiben. Die eventID Zusammen mit der Quelle identifiziert 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 verstehen, was schief gelaufen ist, und schlägt vor, welche Aktionen ausgeführt werden sollen.

Zusätzlich zur Ereignis-ID können Sie ein EventLogEntryType Ereignis angeben, das in das Ereignisprotokoll geschrieben wird. Dies type wird durch ein Symbol und Text in der Spalte "Typ" in der 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.

Erstellen Sie die neue Ereignisquelle während der Installation Ihrer Anwendung. Dadurch kann das Betriebssystem seine 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 mithilfe einer EventLogInstallerOder mithilfe 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 dieser EventLog Instanz angegebene Quelle nicht auf dem Computer registriert ist, in den Ihre Komponente schreibt, ruft die Quelle auf CreateEventSource und WriteEntry registriert sie.

Wenn das System den Source Aufruf über einen Aufruf WriteEntry registrieren muss und die Log Eigenschaft für Ihre EventLog Instanz nicht festgelegt wurde, wird das Protokoll standardmäßig im Anwendungsprotokoll gespeichert.

Die Quelle muss entweder für das Schreiben lokalisierter Einträge oder für das Schreiben von direkten Zeichenfolgen konfiguriert werden. Die WriteEntry Methode schreibt die angegebene Zeichenfolge direkt in das Ereignisprotokoll. Sie 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

Quelle:

EventLog.cs

Quelle:

EventLog.cs

Quelle:

EventLog.cs

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, wenn sie noch nicht vorhanden ist, und schreibt einen Eintrag in das Ereignisprotokoll MyNewLog.

using System;
using System.Diagnostics;
using System.Threading;

class MySample
{

    public static void Main()
    {

        // Create the source, if it does not already exist.
        if (!EventLog.SourceExists("MySource"))
        {
            // An event log source should not be created and immediately used.
            // There is a latency time to enable the source, it should be created
            // prior to executing the application that uses the source.
            // Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "myNewLog");
            Console.WriteLine("CreatingEventSource");
            Console.WriteLine("Exiting, execute the application a second time to use the source.");
            // The source is created.  Exit the application to allow it to be registered.
            return;
        }

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

Option Strict
Option Explicit

Imports System.Diagnostics
Imports System.Threading

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

Hinweise

Verwenden Sie diese Methode, um einen Informationseintrag in das Ereignisprotokoll zu schreiben, indem Sie eine Quelle verwenden, 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. Erstellen Sie die neue Ereignisquelle während der Installation Ihrer Anwendung. Dadurch kann das Betriebssystem seine 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 mithilfe einer EventLogInstallerOder mithilfe der CreateEventSource Methode konfigurieren. Sie müssen über Administratorrechte auf dem Computer verfügen, um eine neue Ereignisquelle zu erstellen.

Die Quelle muss entweder für das Schreiben lokalisierter Einträge oder für das Schreiben von direkten Zeichenfolgen konfiguriert werden. Die WriteEntry Methode schreibt die angegebene Zeichenfolge direkt in das Ereignisprotokoll. Sie 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

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

Quelle:

EventLog.cs

Quelle:

EventLog.cs

Quelle:

EventLog.cs

Quelle:

EventLog.cs

Quelle:

EventLog.cs

Quelle:

EventLog.cs

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, wenn sie noch nicht vorhanden ist, und schreibt einen Eintrag in das Ereignisprotokoll MyNewLog.

using System;
using System.Diagnostics;
using System.Threading;

class MySample{

    public static void Main(){

        // Create the source, if it does not already exist.
        if(!EventLog.SourceExists("MySource"))
        {
             //An event log source should not be created and immediately used.
             //There is a latency time to enable the source, it should be created
             //prior to executing the application that uses the source.
             //Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "MyNewLog");
            Console.WriteLine("CreatedEventSource");
            Console.WriteLine("Exiting, execute the application a second time to use the source.");
            // The source is created.  Exit the application to allow it to be registered.
            return;
        }

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

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

Option Explicit
Option Strict

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        
        If Not EventLog.SourceExists("MySource") Then
            ' Create the source, if it does not already exist.
            ' An event log source should not be created and immediately used.
            ' There is a latency time to enable the source, it should be created
            ' prior to executing the application that uses the source.
            ' Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "MyNewLog")
            Console.WriteLine("CreatingEventSource")
            'The source is created.  Exit the application to allow it to be registered.
            Return
        End If
        
        ' Create an EventLog instance and assign its source.
        Dim myLog As New EventLog()
        myLog.Source = "MySource"
        
        ' Write an informational entry to the event log.    
        myLog.WriteEntry("Writing to event log.")
    End Sub
End Class

Hinweise

Verwenden Sie diese Methode, um einen Informationseintrag in das ereignisprotokoll zu schreiben, das dieser EventLog Instanz 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.

Erstellen Sie die neue Ereignisquelle während der Installation Ihrer Anwendung. Dadurch kann das Betriebssystem seine 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 mithilfe einer EventLogInstallerOder mithilfe 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 dieser EventLog Instanz angegebene Quelle nicht auf dem Computer registriert ist, in den Ihre Komponente schreibt, ruft die Quelle auf CreateEventSource und WriteEntry registriert sie.

Wenn das System den Source Aufruf über einen Aufruf WriteEntry registrieren muss und die Log Eigenschaft für Ihre EventLog Instanz nicht festgelegt wurde, wird das Protokoll standardmäßig im Anwendungsprotokoll gespeichert.

Die Quelle muss entweder für das Schreiben lokalisierter Einträge oder für das Schreiben von direkten Zeichenfolgen konfiguriert werden. Die WriteEntry Methode schreibt die angegebene Zeichenfolge direkt in das Ereignisprotokoll. Sie 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

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

Quelle:

EventLog.cs

Quelle:

EventLog.cs

Quelle:

EventLog.cs

Quelle:

EventLog.cs

Quelle:

EventLog.cs

Quelle:

EventLog.cs

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 Warneintrag in ein Ereignisprotokoll "MyNewLog" auf dem lokalen Computer geschrieben.

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 Eintrags in das Ereignisprotokoll zu schreiben, wobei eine Quelle verwendet wird, die bereits als Ereignisquelle für das entsprechende Protokoll registriert ist. Dies type wird durch ein Symbol und Text in der Spalte "Typ" in der Ereignisanzeige für ein Protokoll angegeben.

Sie müssen die Ereignisquelle erstellen und konfigurieren, bevor Sie den ersten Eintrag mit der Quelle schreiben. Erstellen Sie die neue Ereignisquelle während der Installation Ihrer Anwendung. Dadurch kann das Betriebssystem seine 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 mithilfe einer EventLogInstallerOder mithilfe der CreateEventSource Methode konfigurieren. Sie müssen über Administratorrechte auf dem Computer verfügen, um eine neue Ereignisquelle zu erstellen.

Die Quelle muss entweder für das Schreiben lokalisierter Einträge oder für das Schreiben von direkten Zeichenfolgen konfiguriert werden. Die WriteEntry Methode schreibt die angegebene Zeichenfolge direkt in das Ereignisprotokoll. Sie 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