EventLog Klasse

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.EventLog.dll

Quelle:

EventLog.cs

Stellt Interaktion mit Windows-Ereignisprotokollen bereit.

public ref class EventLog : System::ComponentModel::Component, System::ComponentModel::ISupportInitialize

public class EventLog : System.ComponentModel.Component, System.ComponentModel.ISupportInitialize

type EventLog = class
    inherit Component
    interface ISupportInitialize

Public Class EventLog
Inherits Component
Implements ISupportInitialize

Vererbung

Object

MarshalByRefObject

Component

EventLog

Implementiert

ISupportInitialize

Beispiele

Im folgenden Beispiel wird die Ereignisquelle MySource erstellt, wenn sie noch nicht vorhanden ist, und schreibt einen Eintrag in das Ereignisprotokoll MyNewLog.

Hinweis

Sie müssen diese Anwendung als Administrator ausführen.

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

EventLog Ermöglicht ihnen den Zugriff auf oder anpassen von Windows-Ereignisprotokollen, die Informationen zu wichtigen Software- oder Hardwareereignissen aufzeichnen. Mithilfe von EventLogvorhandenen Protokollen können Sie Einträge in Protokolle schreiben, Ereignisquellen erstellen oder löschen, Protokolle löschen und auf Protokolleinträge reagieren. Sie können auch neue Protokolle erstellen, wenn Sie eine Ereignisquelle erstellen.

Von Bedeutung

Dieser Typ implementiert die IDisposable Schnittstelle. Nach Abschluss der Verwendung sollten Sie den Typ entweder direkt oder indirekt löschen. Rufen Sie die Methode Dispose in einem try/catch-Block auf, um den Typ direkt zu entsorgen. Verwenden Sie zum indirekten Löschen ein Sprachkonstrukt wie using (in C#) oder Using (in Visual Basic). Weitere Informationen finden Sie im Abschnitt "Verwenden eines Objekts, das IDisposable implementiert" im IDisposable Schnittstellenthema.

Zusätzlich zur Bereitstellung des Zugriffs auf einzelne Ereignisprotokolle und deren Einträge ermöglicht ihnen die EventLog Klasse den Zugriff auf die Sammlung aller Ereignisprotokolle. Sie können die static Mitglieder von EventLog Protokollen verwenden, Protokolllisten abrufen, eine Quelle erstellen oder löschen oder ermitteln, ob ein Computer bereits eine bestimmte Quelle enthält.

Es gibt drei Standardereignisprotokolle: Anwendung, System und Sicherheit. Ein Sicherheitsprotokoll ist schreibgeschützt. Andere Anwendungen und Dienste, die Sie installieren, z. B. Active Directory, verfügen möglicherweise über zusätzliche Ereignisprotokolle.

Bei verwendung der EventLog Klasse gibt es Sicherheitsüberlegungen. EventLog erfordert EventLogPermission Berechtigungen für bestimmte Aktionen. Es wird empfohlen, nicht EventLogPermission teilweise vertrauenswürdigen Code zu gewähren. Sie sollten niemals ein Ereignisprotokollobjekt, einschließlich EventLogEntryCollection und EventLogEntry Objekte, an weniger vertrauenswürdigen Code übergeben. Beispielsweise kann das Erstellen eines Objekts, das Schreiben eines EventLog Eintrags und das Anschließende Übergeben des EventLog Objekts an teilweise vertrauenswürdigen Code ein Sicherheitsproblem erstellen, da die Möglichkeit zum Lesen und Schreiben in das Ereignisprotokoll Code ermöglicht, Aktionen wie das Ausstellen von Ereignisprotokollmeldungen im Namen einer anderen Anwendung auszuführen.

Ab Windows Vista bestimmt die Benutzerkontensteuerung (User Account Control, UAC) die Anmeldeinformationen eines Benutzers. Wenn Sie Mitglied der Gruppe "Integrierte Administratoren" sind, werden Ihnen zwei Laufzeitzugriffstoken zugewiesen: ein Standardbenutzerzugriffstoken und ein Administratorzugriffstoken. Standardmäßig befinden Sie sich in der Standardbenutzerrolle. Um den Code auszuführen, der auf das Sicherheitsprotokoll zugreift, müssen Sie ihre Anmeldeinformationen zuerst von Standardbenutzer zu Administrator erhöhen. Sie können dies tun, wenn Sie eine Anwendung starten, indem Sie das Kontextmenü für die Anwendung öffnen (wenn Sie eine Maus verwenden, klicken Sie mit der rechten Maustaste auf das Anwendungssymbol), und geben Sie an, dass Sie als Administrator ausgeführt werden möchten.

Sie können benutzerdefinierte EventLog Ereignisprotokolle erstellen, die Sie über die Ereignisanzeige des Servers anzeigen können. Verwenden Sie die RegisterDisplayName Methode, um einen lokalisierten Namen für Ihr Ereignisprotokoll in der Ereignisanzeige anzuzeigen. Verwenden Sie die ModifyOverflowPolicy Methode, um das Verhalten Ihres Ereignisprotokolls zu konfigurieren, wenn sie die maximale Protokollgröße erreicht.

Um aus einem Ereignisprotokoll zu lesen, geben Sie den Protokollnamen (Log Eigenschaft) und den Servercomputernamen (MachineName Eigenschaft für das Ereignisprotokoll) an. Wenn Sie den Servercomputernamen nicht angeben, wird der lokale Computer "." angenommen. Es ist nicht erforderlich, die Ereignisquelle (Source Eigenschaft) anzugeben, da eine Quelle nur zum Schreiben in Protokolle erforderlich ist. Die Entries Eigenschaft wird automatisch mit der Liste der Einträge des Ereignisprotokolls aufgefüllt.

Wenn Sie in ein Ereignisprotokoll schreiben möchten, geben Oder erstellen Sie eine Ereignisquelle (Source Eigenschaft). Sie müssen über Administratoranmeldeinformationen auf dem Computer verfügen, um eine neue Ereignisquelle zu erstellen. Die Ereignisquelle registriert Ihre Anwendung mit dem Ereignisprotokoll als gültige Quelle von Einträgen. Sie können die Ereignisquelle verwenden, um jeweils nur in ein Protokoll zu schreiben. Die Source Eigenschaft kann eine beliebige zufällige Zeichenfolge sein, aber der Name muss sich von anderen Quellen auf dem Computer unterscheiden. Die Ereignisquelle ist in der Regel der Name der Anwendung oder eine andere identifizierende Zeichenfolge. Beim Versuch, einen doppelten Source Wert zu erstellen, wird eine Ausnahme ausgelöst. Ein einzelnes Ereignisprotokoll kann jedoch mehreren Quellen zugeordnet werden.

Wenn die Ereignisquelle für das ereignisprotokoll, das der EventLog Instanz zugeordnet ist, nicht vorhanden ist, wird eine neue Ereignisquelle erstellt. Um eine Ereignisquelle in Windows Vista und höher oder Windows Server 2003 zu erstellen, müssen Sie über Administratoranmeldeinformationen verfügen.

Diese Anforderung liegt daran, dass alle Ereignisprotokolle, einschließlich Sicherheitsprotokollen, durchsucht werden müssen, um festzustellen, ob die Ereignisquelle eindeutig ist. Ab Windows Vista verfügen Benutzer nicht über die Berechtigung für den Zugriff auf das Sicherheitsprotokoll. daher wird ein SecurityException Geworfen.

Von Bedeutung

Zum Erstellen oder Löschen einer Ereignisquelle ist die Synchronisierung des zugrunde liegenden Codes mithilfe eines benannten Mutex erforderlich. Wenn eine hoch privilegierte Anwendung den benannten Mutex sperrt, bewirkt der Versuch, eine Ereignisquelle zu erstellen oder zu löschen, dass die Anwendung nicht mehr reagiert, bis die Sperre freigegeben wird. Um dieses Problem zu verhindern, erteilen Sie UnmanagedCode niemals die Berechtigung für nicht vertrauenswürdigen Code. Darüber hinaus UnmanagedCode kann die Berechtigung möglicherweise andere Berechtigungen umgehen und sollte nur vertrauenswürdigen Code gewährt werden.

Anwendungen und Dienste sollten in das Anwendungsprotokoll oder in ein benutzerdefiniertes Protokoll schreiben. Gerätetreiber sollten in das Systemprotokoll schreiben. Wenn Sie die Log Eigenschaft nicht explizit festlegen, wird das Ereignisprotokoll standardmäßig im Anwendungsprotokoll gespeichert.

Hinweis

Es gibt nichts, um eine Anwendung vor dem Schreiben als registrierte Quelle zu schützen. Wenn einer Anwendung die Berechtigung erteilt Write wird, kann sie Ereignisse für jede gültige Quelle schreiben, die auf dem Computer registriert ist.

Verwenden Sie die WriteEvent Methoden, WriteEntry um Ereignisse in ein Ereignisprotokoll zu schreiben. Sie müssen eine Ereignisquelle zum Schreiben von Ereignissen angeben; 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 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 mithilfe eines EventLogInstaller Objekts oder der CreateEventSource Methode konfigurieren. Sie müssen über Administratoranmeldeinformationen auf dem Computer verfügen, um eine neue Ereignisquelle zu erstellen.

Jede Quelle kann jeweils nur in ein Ereignisprotokoll schreiben; Ihre Anwendung kann jedoch mehrere Quellen verwenden, um in mehrere Ereignisprotokolle zu schreiben. Ihre Anwendung kann z. B. mehrere Quellen erfordern, die für unterschiedliche Ereignisprotokolle oder unterschiedliche Ressourcendateien konfiguriert sind. Um die Konfigurationsdetails einer vorhandenen Quelle zu ändern, müssen Sie die Quelle löschen und dann mit der neuen Konfiguration erstellen. Wenn andere Anwendungen oder Komponenten die vorhandene Quelle verwenden, erstellen Sie eine neue Quelle mit der aktualisierten Konfiguration, anstatt die vorhandene Quelle zu löschen.

Sie können die Ereignisquelle mit lokalisierten Ressourcen für Ihre Ereigniskategorie und Nachrichtenzeichenfolgen registrieren. Ihre Anwendung kann Ereignisprotokolleinträge mithilfe von Ressourcenbezeichnern schreiben, anstatt die tatsächlichen Zeichenfolgenwerte anzugeben. Weitere Informationen zum Konfigurieren der Quelle mit Ressourcendateien finden Sie in den EventLogInstaller Klassen und EventSourceCreationData Klassen.

Wenn Ihre Anwendung Zeichenfolgenwerte direkt in das Ereignisprotokoll schreibt, müssen Sie die Ressourcendateieigenschaften für die Quelle nicht festlegen. Die Quelle muss entweder für das Schreiben lokalisierter Einträge oder für das Schreiben von direkten Zeichenfolgen konfiguriert werden. 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.

Beim Schreiben von Ereignissen müssen Sie mindestens eine Nachrichtenzeichenfolge oder den Ressourcenbezeichner für eine Nachrichtenzeichenfolge angeben. Andere Ereigniseigenschaften sind optional. Beispiele für optionale Ereigniseinstellungen sind:

• Sie können das EventLogEntryType Symbol festlegen, das von der Ereignisanzeige für den Eintrag angezeigt wird.

• Sie können einen Kategoriebezeichner für das Ereignis angeben, wenn Ihre Anwendung Kategorien zum Filtern der Ereignisse verwendet.

• Sie können Binäre Daten an Ihren Ereigniseintrag anfügen, wenn Sie zusätzliche Informationen einem bestimmten Ereignis zuordnen möchten.

Von Bedeutung

Die Ereignisprotokollierung verbraucht Speicherplatz, Prozessorzeit und andere Systemressourcen. Es ist wichtig, nur wichtige Informationen zu protokollieren. Es wird empfohlen, Ereignisprotokollaufrufe nicht im Hauptcodepfad, sondern in einem Fehlerpfad zu platzieren, sodass sie die Leistung nicht beeinträchtigen.

Eine Liste der anfänglichen Eigenschaftswerte für eine Instanz von EventLog, finden Sie im EventLog Konstruktor.

Konstruktoren

Name	Beschreibung
EventLog()	Initialisiert eine neue Instanz der EventLog-Klasse. Ordnet die Instanz keinem Protokoll zu.
EventLog(String, String, String)	Initialisiert eine neue Instanz der EventLog-Klasse. Ordnet die Instanz einem Protokoll auf dem angegebenen Computer zu und erstellt oder weist der angegebenen Quelle die EventLogangegebene Quelle zu.
EventLog(String, String)	Initialisiert eine neue Instanz der EventLog-Klasse. Ordnet die Instanz einem Protokoll auf dem angegebenen Computer zu.
EventLog(String)	Initialisiert eine neue Instanz der EventLog-Klasse. Ordnet die Instanz einer Anmeldung auf dem lokalen Computer zu.

Eigenschaften

Name	Beschreibung
EnableRaisingEvents	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die EventLog Ereignisbenachrichtigungen empfangen EntryWritten .
Entries	Ruft den Inhalt des Ereignisprotokolls ab.
Log	Dient zum Abrufen oder Festlegen des Namens des Protokolls, aus dem gelesen oder geschrieben werden soll.
LogDisplayName	Ruft den Anzeigenamen des Ereignisprotokolls ab.
MachineName	Dient zum Abrufen oder Festlegen des Namens des Computers, auf dem Ereignisse gelesen oder geschrieben werden sollen.
MaximumKilobytes	Ruft die maximale Ereignisprotokollgröße in Kilobyte ab oder legt diese fest.
MinimumRetentionDays	Diese Eigenschaft ist veraltet.
OverflowAction	Ruft das konfigurierte Verhalten zum Speichern neuer Einträge ab, wenn das Ereignisprotokoll seine maximale Protokolldateigröße erreicht.
Source	Dient zum Abrufen oder Festlegen des Quellnamens, der beim Schreiben in das Ereignisprotokoll registriert und verwendet werden soll.
SynchronizingObject	Dient zum Abrufen oder Festlegen des Objekts, das zum Marshallen der Ereignishandleraufrufe verwendet wird, die als Ergebnis eines EventLog geschriebenen Eintragsereignisses ausgegeben wurden.

Methoden

Name	Beschreibung
BeginInit()	Beginnt mit der Initialisierung eines in EventLog einem Formular verwendeten Formulars oder wird von einer anderen Komponente verwendet. Die Initialisierung erfolgt zur Laufzeit.
Clear()	Entfernt alle Einträge aus dem Ereignisprotokoll.
Close()	Schließt das Ereignisprotokoll und gibt Lese- und Schreibhandles frei.
CreateEventSource(EventSourceCreationData)	Richtet eine gültige Ereignisquelle zum Schreiben lokalisierter Ereignismeldungen ein, wobei die angegebenen Konfigurationseigenschaften für die Ereignisquelle und das entsprechende Ereignisprotokoll verwendet werden.
CreateEventSource(String, String, String)	Veraltet. Legt den angegebenen Quellnamen als gültige Ereignisquelle zum Schreiben von Einträgen in ein Protokoll auf dem angegebenen Computer fest. Diese Methode kann auch verwendet werden, um ein neues benutzerdefiniertes Protokoll auf dem angegebenen Computer zu erstellen.
CreateEventSource(String, String)	Legt den angegebenen Quellnamen als gültige Ereignisquelle zum Schreiben von Einträgen in ein Protokoll auf dem lokalen Computer fest. Diese Methode kann auch ein neues benutzerdefiniertes Protokoll auf dem lokalen Computer erstellen.
Delete(String, String)	Entfernt ein Ereignisprotokoll vom angegebenen Computer.
Delete(String)	Entfernt ein Ereignisprotokoll vom lokalen Computer.
DeleteEventSource(String, String)	Entfernt die Ereignisquellregistrierung der Anwendung vom angegebenen Computer.
DeleteEventSource(String)	Entfernt die Ereignisquellregistrierung aus dem Ereignisprotokoll des lokalen Computers.
Dispose(Boolean)	Gibt die nicht verwalteten Ressourcen frei, die von den EventLogverwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei.
EndInit()	Beendet die Initialisierung eines in EventLog einem Formular oder einer anderen Komponente verwendeten Komponente. Die Initialisierung erfolgt zur Laufzeit.
Exists(String, String)	Bestimmt, ob das Protokoll auf dem angegebenen Computer vorhanden ist.
Exists(String)	Bestimmt, ob das Protokoll auf dem lokalen Computer vorhanden ist.
GetEventLogs()	Sucht nach allen Ereignisprotokollen auf dem lokalen Computer und erstellt ein Array von EventLog Objekten, die die Liste enthalten.
GetEventLogs(String)	Sucht nach allen Ereignisprotokollen auf dem angegebenen Computer und erstellt ein Array von EventLog Objekten, die die Liste enthalten.
LogNameFromSourceName(String, String)	Ruft den Namen des Protokolls ab, in dem die angegebene Quelle registriert ist.
ModifyOverflowPolicy(OverflowAction, Int32)	Ändert das konfigurierte Verhalten zum Schreiben neuer Einträge, wenn das Ereignisprotokoll seine maximale Dateigröße erreicht.
RegisterDisplayName(String, Int64)	Gibt den lokalisierten Namen des Ereignisprotokolls an, das in der Serverereignisanzeige angezeigt wird.
SourceExists(String, String)	Bestimmt, ob eine Ereignisquelle auf einem angegebenen Computer registriert ist.
SourceExists(String)	Bestimmt, ob eine Ereignisquelle auf dem lokalen Computer registriert ist.
WriteEntry(String, EventLogEntryType, Int32, Int16, Byte[])	Schreibt einen Eintrag mit dem angegebenen Nachrichtentext, anwendungsdefinierter Ereignisbezeichner und anwendungsdefinierter Kategorie in das Ereignisprotokoll und fügt binäre Daten an die Nachricht an.
WriteEntry(String, EventLogEntryType, Int32, Int16)	Schreibt einen Eintrag mit dem angegebenen Nachrichtentext, anwendungsdefiniertem Ereignisbezeichner und anwendungsdefinierter Kategorie in das Ereignisprotokoll.
WriteEntry(String, EventLogEntryType, Int32)	Schreibt einen Eintrag mit dem angegebenen Nachrichtentext und anwendungsdefiniertem Ereignisbezeichner in das Ereignisprotokoll.
WriteEntry(String, EventLogEntryType)	Schreibt einen Fehler-, Warnungs-, Informations-, Erfolgsüberwachungs- oder Fehlerüberwachungseintrag mit dem angegebenen Meldungstext in das Ereignisprotokoll.
WriteEntry(String, String, EventLogEntryType, Int32, Int16, Byte[])	Schreibt einen Eintrag mit dem angegebenen Nachrichtentext, anwendungsdefiniertem Ereignisbezeichner und anwendungsdefinierter Kategorie in das Ereignisprotokoll (unter Verwendung der angegebenen registrierten Ereignisquelle) und fügt binäre Daten an die Nachricht an.
WriteEntry(String, String, EventLogEntryType, Int32, Int16)	Schreibt einen Eintrag mit dem angegebenen Nachrichtentext, anwendungsdefiniertem Ereignisbezeichner und anwendungsdefinierter Kategorie in das Ereignisprotokoll unter Verwendung der angegebenen registrierten Ereignisquelle. Dies category kann von der Ereignisanzeige verwendet werden, um Ereignisse im Protokoll zu filtern.
WriteEntry(String, String, EventLogEntryType, Int32)	Schreibt einen Eintrag mit dem angegebenen Nachrichtentext und anwendungsdefiniertem Ereignisbezeichner in das Ereignisprotokoll unter Verwendung der angegebenen registrierten Ereignisquelle.
WriteEntry(String, String, EventLogEntryType)	Schreibt einen Fehler-, Warnungs-, Informations-, Erfolgsüberwachungs- oder Fehlerüberwachungseintrag mit dem angegebenen Meldungstext in das Ereignisprotokoll unter Verwendung der angegebenen registrierten Ereignisquelle.
WriteEntry(String, String)	Schreibt einen Informationstypeintrag mit dem angegebenen Nachrichtentext in das Ereignisprotokoll mithilfe der angegebenen registrierten Ereignisquelle.
WriteEntry(String)	Schreibt einen Informationstypeintrag mit dem angegebenen Nachrichtentext in das Ereignisprotokoll.
WriteEvent(EventInstance, Byte[], Object[])	Schreibt einen Ereignisprotokolleintrag mit den angegebenen Ereignisdaten, Zeichenfolgen zum Ersetzen von Nachrichten und zugeordneten Binärdaten.
WriteEvent(EventInstance, Object[])	Schreibt einen lokalisierten Eintrag in das Ereignisprotokoll.
WriteEvent(String, EventInstance, Byte[], Object[])	Schreibt einen Ereignisprotokolleintrag mit den angegebenen Ereignisdaten, Zeichenfolgen zum Ersetzen von Nachrichten und zugeordneten Binärdaten und verwendet die angegebene registrierte Ereignisquelle.
WriteEvent(String, EventInstance, Object[])	Schreibt einen Ereignisprotokolleintrag mit den angegebenen Ereignisdaten- und Nachrichtenersetzungszeichenfolgen mithilfe der angegebenen registrierten Ereignisquelle.

Ereignisse

Name	Beschreibung
EntryWritten	Tritt auf, wenn ein Eintrag in ein Ereignisprotokoll auf dem lokalen Computer geschrieben wird.

Weitere Informationen

• EventLogInstaller
• EventLogEntry
• EntryWrittenEventArgs
• ServiceBase