EventLog.WriteEntry-Methode (String)

Verwenden Sie diese Methode, um einen Informationseintrag in das Ereignisprotokoll zu schreiben, das dieser EventLog-Instanz zugeordnet ist. Wenn Sie einen anderen EventLogEntryType angeben möchten, verwenden Sie eine andere Überladung von WriteEntry.

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

Sie müssen die Source-Eigenschaft in der 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 der Anwendung. Dies gibt dem Betriebssystem Gelegenheit, die Liste der registrierten Ereignisquellen und deren Konfiguration zu aktualisieren. Wenn die Liste der Ereignisquellen vom Betriebssystem nicht aktualisiert wurde und Sie versuchen, ein Ereignis für die neue Quelle zu schreiben, schlägt der Schreibvorgang fehl. Sie können eine neue Quelle entweder mithilfe eines EventLogInstaller oder mithilfe der CreateEventSource-Methode erstellen. Sie benötigen Administratorrechte für den Computer, um eine neue Ereignisquelle zu erstellen.

Wenn die in der Source-Eigenschaft dieser EventLog-Instanz angegebene Quelle nicht auf dem Computer registriert ist, auf dem die Komponente schreibt, ruft WriteEntry zum Registrieren der Quelle CreateEventSource auf.

Hinweis
Wenn Sie keinen MachineName für die EventLog-Instanz angeben, bevor Sie CreateEventSource oder WriteEntry aufrufen, wird der lokale Computer (".") verwendet.

Wenn das System die Source durch einen Aufruf von WriteEntry registrieren muss und die Log-Eigenschaft nicht auf die EventLog-Instanz festgelegt wurde, wird als Standardprotokoll das Anwendungsprotokoll verwendet.

Hinweis
Viele der oben aufgeführten Ausnahmen werden durch Fehler generiert, die während der Registrierung der Source aufgetreten sind.

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, ohne eine lokalisierbare Meldungsressourcendatei zu verwenden. Verwenden Sie die WriteEvent-Methode, um Ereignisse mithilfe einer lokalisierten Meldungsressourcendatei zu schreiben.

Wenn die Anwendung beim Schreiben von Einträgen sowohl Ressourcenbezeichner als auch Zeichenfolgenwerte verwendet, müssen Sie zwei getrennte 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 einem Remotecomputer schreiben, ist der Wert der Meldung (die Textzeichenfolge) möglicherweise nicht erwartungsgemäß, wenn auf dem Remotecomputer .NET Framework nicht ausgeführt wird.

Hinweis
Wenn der message-Parameter ein NUL-Zeichen enthält, bricht die Meldung im Ereignisprotokoll nach dem NUL-Zeichen ab.

Im folgenden Beispiel wird die Quelle MySource erstellt, wenn sie nicht bereits vorhanden ist, und anschließend ein Eintrag in das Ereignisprotokoll MyNewLog geschrieben.

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

    }
}
   

.NET Framework

.NET Framework Client Profile

• EventLogPermission  

  zum Schreiben von Ereignisprotokollinformationen auf dem Computer. Zugeordnete Enumeration: EventLogPermissionAccess.Write

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

Referenz