System.Diagnostics.Eventing.Reader Namespace

Mithilfe des System.Diagnostics.Eventing.Reader-Namespaces können Sie Anwendungen entwickeln, die Ereignisprotokolle lesen und verwalten. Using the System.Diagnostics.Eventing.Reader namespace, you can develop applications that read and manage event logs. Ein Ereignis in einem Ereignisprotokoll enthält Informationen, eine Warnung oder einen Fehler, die von bestimmten Anwendungen, Diensten oder Betriebssystemkomponenten veröffentlicht wurden. An event in an event log contains information, a warning, or an error that has been published by a specific application, service, or operating system component. Diese Ereignisse werden von Anwendungen gelesen, die den Computerzustand überwachen, sowie von Anwendungen, die Aktionen ausführen, wenn ein bestimmtes Ereignis auftritt. These events are read by applications that monitor a computer's health and applications that take action when specific events occur. Weitere Informationen finden Sie unter Technologiezusammenfassung zum Lesen und Verwalten von Ereignisprotokollen und Ereignisprotokollszenarien. For more information, see Technology Summary for Reading and Managing Event Logs and Event Log Scenarios.

Klassen

EventBookmark

Stellt einen Platzhalter (Lesezeichen) innerhalb eines Streams von Ereignissen dar.Represents a placeholder (bookmark) within an event stream. Mit dem Platzhalter können Sie eine Position im Stream markieren und zu dieser zurückkehren.You can use the placeholder to mark a position and return to this position in a stream of events. Eine Instanz dieses Objekts kann von einem EventRecord-Objekt abgerufen werden; diese entspricht dann der Position des Ereignisdatensatzes.An instance of this object can be obtained from an EventRecord object, in which case it corresponds to the position of that event record.

EventKeyword

Stellt ein Schlüsselwort für ein Ereignis dar.Represents a keyword for an event. Schlüsselwörter werden in einem Ereignisanbieter definiert und zum Gruppieren von Ereignissen mit ähnlichen Ereignissen (anhand ihrer Verwendung) verwendet.Keywords are defined in an event provider and are used to group the event with other similar events (based on the usage of the events).

EventLevel

Enthält eine Ereignisebene, die in einem Ereignisanbieter definiert wird.Contains an event level that is defined in an event provider. Die Ebene gibt den Schweregrad des Ereignisses an.The level signifies the severity of the event.

EventLogConfiguration

Enthält statische Informationen und Konfigurationseinstellungen für ein Ereignisprotokoll.Contains static information and configuration settings for an event log. Zahlreiche Konfigurationseinstellungen wurden vom Ereignisanbieter festgelegt, der das Protokoll erstellt hat.Many of the configurations settings were defined by the event provider that created the log.

EventLogException

Stellt die Basisklasse für alle Ausnahmen dar, die ausgelöst werden, wenn es zu Fehlern beim Lesen von Ereignisprotokollinformationen kommt.Represents the base class for all the exceptions that are thrown when an error occurs while reading event log related information.

EventLogInformation

Ermöglicht den Zugriff auf die Laufzeiteigenschaften von aktiven Ereignisprotokollen und aktiven Ereignisprotokolldateien.Allows you to access the run-time properties of active event logs and event log files. Zu diesen Eigenschaften gehören die Anzahl der Ereignisse im Protokoll, die Größe des Protokolls, ein Wert, der angibt, ob das Protokoll voll ist, sowie eine Angabe dazu, wann zum letzten Mal auf das Protokoll zugegriffen oder in das Protokoll geschrieben wurde.These properties include the number of events in the log, the size of the log, a value that determines whether the log is full, and the last time the log was written to or accessed.

EventLogInvalidDataException

Stellt die Ausnahme dar, die ausgelöst wird, wenn ein Ereignisanbieter ungültige Daten in einem Ereignis veröffentlicht.Represents the exception thrown when an event provider publishes invalid data in an event.

EventLogNotFoundException

Stellt die Ausnahme dar, die ausgelöst wird, wenn ein angefordertes Ereignisprotokoll nicht vorhanden ist, das i. d. R. über den Namen oder den Dateipfad angegeben wird.Represents the exception that is thrown when a requested event log (usually specified by the name of the event log or the path to the event log file) does not exist.

EventLogPropertySelector

Enthält ein Zeichenfolgenarray, das XPath-Abfragen für Elemente in der XML-Darstellung eines Ereignisses darstellt, das auf dem Ereignisschema basiert.Contains an array of strings that represent XPath queries for elements in the XML representation of an event, which is based on the Event Schema. Die Abfragen in diesem Objekt werden zum Extrahieren von Werten aus diesem Ereignis verwendet.The queries in this object are used to extract values from the event.

EventLogProviderDisabledException

Stellt die Ausnahme dar, die ausgelöst wird, wenn der angegebene Name des Ereignisanbieters auf einen deaktivierten Ereignisanbieter verweist.Represents the exception that is thrown when a specified event provider name references a disabled event provider. Ein deaktivierter Ereignisanbieter kann keine Ereignisse veröffentlichen.A disabled event provider cannot publish events.

EventLogQuery

Stellt eine Abfrage für Ereignisse in einem Ereignisprotokoll dar sowie die Einstellungen für die Ausführung der Abfrage und den verwendeten Computer.Represents a query for events in an event log and the settings that define how the query is executed and on what computer the query is executed on.

EventLogReader

Ermöglicht das Lesen von Ereignissen aus einem Ereignisprotokoll anhand von Ereignisabfragen.Enables you to read events from an event log based on an event query. Die Ereignisse, die von diesem Objekt gelesen werden, werden als EventRecord-Objekte zurückgegeben.The events that are read by this object are returned as EventRecord objects.

EventLogReadingException

Stellt eine Ausnahme dar, die ausgelöst wird, wenn beim Lesen, Abfragen oder Abonnieren von Ereignissen in einem Ereignisprotokoll ein Fehler auftritt.Represents an exception that is thrown when an error occurred while reading, querying, or subscribing to the events in an event log.

EventLogRecord

Enthält die Eigenschaften einer Ereignisinstanz für ein Ereignis, das von einem EventLogReader-Objekt empfangen wird.Contains the properties of an event instance for an event that is received from an EventLogReader object. Die Ereigniseigenschaften enthalten Informationen über das Ereignis wie den Namen des Computers, für den das Ereignis protokolliert wurde und den Zeitpunkt der Erstellung des Ereignisses.The event properties provide information about the event such as the name of the computer where the event was logged and the time that the event was created.

EventLogSession

Wird verwendet, um auf den Ereignisprotokolldienst auf dem lokalen Computer oder auf einem Remotecomputer zuzugreifen, und Informationen über Ereignisprotokolle und Ereignisanbieter auf dem Computer zu verwalten und zu sammeln.Used to access the Event Log service on the local computer or a remote computer so you can manage and gather information about the event logs and event providers on the computer.

EventLogStatus

Enthält den Statuscode oder den Fehlercode für ein bestimmtes Ereignisprotokoll.Contains the status code or error code for a specific event log. Dieser Status kann verwendet werden, um die Verfügbarkeit eines Ereignisprotokolls für einen Vorgang zu bestimmen.This status can be used to determine if the event log is available for an operation.

EventLogWatcher

Ermöglicht das Abonnieren von eingehenden Ereignissen.Allows you to subscribe to incoming events. Jedes Mal, wenn ein gewünschtes Ereignis in einem Ereignisprotokoll veröffentlicht wird, wird das EventRecordWritten-Ereignis ausgelöst, und die Methode zur Behandlung dieses Ereignisses wird ausgeführt.Each time a desired event is published to an event log, the EventRecordWritten event is raised, and the method that handles this event will be executed.

EventMetadata

Enthält die Metadaten (Eigenschaften und Einstellungen) für ein Ereignis, das in einem Ereignisanbieter definiert wird.Contains the metadata (properties and settings) for an event that is defined in an event provider.

EventOpcode

Enthält einen Ereignisopcode, der in einem Ereignisanbieter definiert wird.Contains an event opcode that is defined in an event provider. Ein Opcode definiert einen numerischen Wert zur Identifizierung einer Aktivität oder eines Punkts in einer Aktivität, die von der Anwendung durchgeführt wurde, als das Ereignis ausgelöst wurde.An opcode defines a numeric value that identifies the activity or a point within an activity that the application was performing when it raised the event.

EventProperty

Enthält den Wert einer Ereigniseigenschaft, die vom Ereignisanbieter angegeben wird, wenn das Ereignis veröffentlicht wird.Contains the value of an event property that is specified by the event provider when the event is published.

EventRecord

Definiert die Eigenschaften einer Ereignisinstanz für ein Ereignis, das von einem EventLogReader-Objekt empfangen wird.Defines the properties of an event instance for an event that is received from an EventLogReader object. Die Ereigniseigenschaften enthalten Informationen über das Ereignis wie den Namen des Computers, für den das Ereignis protokolliert wurde und den Zeitpunkt der Erstellung des Ereignisses.The event properties provide information about the event such as the name of the computer where the event was logged and the time the event was created. Diese Klasse ist eine abstrakte Klasse.This class is an abstract class. Sie wird von der EventLogRecord-Klasse implementiert.The EventLogRecord class implements this class.

EventRecordWrittenEventArgs

Wenn das EventRecordWritten-Ereignis ausgelöst wird, wird eine Instanz des Objekts an die Delegatenmethode übergeben, die das Ereignis behandelt.When the EventRecordWritten event is raised, an instance of this object is passed to the delegate method that handles the event. Das Objekt enthält das Ereignis, das im Ereignisprotokoll veröffentlicht wurde oder die Ausnahme, die durch einen Fehler beim Abonnieren des Ereignisses ausgelöst wurde.This object contains the event that was published to the event log or the exception that occurred when the event subscription failed.

EventTask

Enthält eine Ereignisaufgabe, die in einem Ereignisanbieter definiert wird.Contains an event task that is defined in an event provider. Die Aufgabe identifiziert einen Teil für eine Anwendung oder eine Komponente, die ein Ereignis veröffentlichen.The task identifies a portion of an application or a component that publishes an event. Eine Aufgabe ist ein 16-Bit-Wert, bei dem die ersten 16 Werte reserviert sind.A task is a 16-bit value with 16 top values reserved.

ProviderMetadata

Enthält statische Informationen über einen Ereignisanbieter, z. B. den Namen und die ID des Anbieters sowie eine Auflistung der für den Anbieter definierten Ereignisse.Contains static information about an event provider, such as the name and id of the provider, and the collection of events defined in the provider.

Enumerationen

EventLogIsolation

Definiert die Standardzugriffsberechtigungen für das Ereignisprotokoll. Die Anwendungs- und Systemwerte geben an, dass die Zugriffssteuerungsliste (ACL) vom Protokoll zusammen mit dem entsprechenden Windows-Protokoll (dem Anwendungsprotokoll oder dem Systemereignisprotokoll) verwendet wird; außerdem wird die Ereignisablaufverfolgung für Windows (Event Tracing for Windows, ETW)-Sitzung mit anderen Protokollen der gleichen Isolation verwendet. Alle Kanäle mit benutzerdefinierter Isolation verwenden eine private ETW-Sitzung.All channels with Custom isolation use a private ETW session.

EventLogMode

Bestimmt die Behandlung eines Ereignisprotokolls durch den Ereignisprotokolldienst, wenn das Protokoll die maximal zulässige Größe erreicht hat (und keine weiteren Elemente mehr aufnehmen kann).Determines the behavior for the event log service handles an event log when the log reaches its maximum allowed size (when the event log is full).

EventLogType

Definiert, welche Ereignisse in einem Ereignisprotokoll protokolliert werden. Jedes Protokoll kann nur einen Ereignistyp enthalten.Each log can only contain one type of event.

PathType

Gibt an, dass eine Zeichenfolge den Namen eines Ereignisprotokolls oder den Dateisystempfad für eine Ereignisprotokolldatei enthält.Specifies that a string contains a name of an event log or the file system path to an event log file.

SessionAuthentication

Definierte Werte für den Authentifizierungstyp, der während einer RPC-Anmeldung bei einem Server verwendet wird. Diese Anmeldung erfolgt, wenn Sie ein EventLogSession-Objekt erstellen, das eine Verbindung zu einem Remotecomputer angibt.This login occurs when you create a EventLogSession object that specifies a connection to a remote computer.

StandardEventKeywords

Definiert die Standardschlüsselwörter, die Ereignissen vom Ereignisanbieter hinzugefügt werden. Weitere Informationen über Schlüsselwörter finden Sie unter EventKeyword.For more information about keywords, see EventKeyword.

StandardEventLevel

Definiert die Standardereignisebenen, die im Ereignisprotokolldienst verwendet werden. Die Ebene definiert den Schweregrad des Ereignisses. Neben den Standardebenen können auch benutzerdefinierte Ereignisebenen definiert werden. Weitere Informationen über Ebenen finden Sie unter EventLevel.For more information about levels, see EventLevel.

StandardEventOpcode

Definiert die Standard-Opcodes, die Ereignissen vom Ereignisanbieter hinzugefügt werden. Weitere Informationen zu Opcodes finden Sie unter EventOpcode.For more information about opcodes, see EventOpcode.

StandardEventTask

Definiert die Standardaufgaben, die mit Ereignissen im Ereignisanbieter verknüpft sind. Weitere Informationen zu Aufgaben finden Sie unter EventTask.For more information about tasks, see EventTask.