System.Diagnostics.Eventing.Reader Пространство имен

Используя пространство имен System.Diagnostics.Eventing.Reader, можно разрабатывать приложения, которые считывают журналы событий и управляют ими. Using the System.Diagnostics.Eventing.Reader namespace, you can develop applications that read and manage event logs. Событие в журнале событий содержит сведения, предупреждение или ошибку, опубликованную специальным приложением, службой или компонентом операционной системы. 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. Эти события считывают приложения, осуществляющие мониторинг состояния компьютера, и приложения, выполняющие действия при наступлении определенных событий. These events are read by applications that monitor a computer's health and applications that take action when specific events occur. Дополнительные сведения см. в разделах Технологическая сводка по чтению журналов событий и управлению ими и Сценарии работы с журналами событий. For more information, see Technology Summary for Reading and Managing Event Logs and Event Log Scenarios.

Классы

EventBookmark

Представляет местозаполнитель (закладку) в потоке событий.Represents a placeholder (bookmark) within an event stream. Местозаполнитель можно использовать для пометки события и возвращения к данной позиции в потоке событий.You can use the placeholder to mark a position and return to this position in a stream of events. Экземпляр данного объекта можно получить из объекта EventRecord; в этом случае он соответствует позиции данной записи события.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

Представляет ключевое слово для события.Represents a keyword for an event. Ключевые слова определены в поставщике событий и используются для группирования события с другими идентичными событиями в соответствии с использованием событий.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

Содержит уровень события, определенный в поставщике событий.Contains an event level that is defined in an event provider. Данный уровень указывает серьезность события.The level signifies the severity of the event.

EventLogConfiguration

Содержит статическую информацию и параметры конфигурации для журнала событий.Contains static information and configuration settings for an event log. Многие параметры конфигураций были определены поставщиком событий, создавшим журнал.Many of the configurations settings were defined by the event provider that created the log.

EventLogException

Представляет базовый класс для всех исключений, вызываемых при происхождении ошибки в ходе считывании информации, связанной с журналом событий.Represents the base class for all the exceptions that are thrown when an error occurs while reading event log related information.

EventLogInformation

Позволяет осуществлять доступ к свойствам времени выполнения активных журналов событий и файлов журналов событий.Allows you to access the run-time properties of active event logs and event log files. Эти свойства включают количество событий в журнале, размер журнала, значение, определяющее заполнение журнала и время последнего доступа к журналу или произведения в нем записи.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

Представляет исключение, вызываемое при публикации поставщиком данных недопустимых данных в событии.Represents the exception thrown when an event provider publishes invalid data in an event.

EventLogLink

Представляет связь между поставщиком событий и журналом событий, в котором поставщик публикует данные событий.Represents a link between an event provider and an event log that the provider publishes events into. Этот объект не может быть использован для создания объектов.This object cannot be instantiated.

EventLogNotFoundException

Представляет исключение, вызываемое в случае, если запрошенный журнал событий (как правило, указывается имя журнала событий или путь к файлу журнала событий) не существует.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

Содержит массив строк, представляющих запросы XPath для элементов в представлении XML события на основе схемы событий.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. Запросы в данном объекте используются для извлечения значений из события.The queries in this object are used to extract values from the event.

EventLogProviderDisabledException

Представляет исключение, которое вызывается, когда определенное имя поставщика событий ссылается на отключенного поставщика событий.Represents the exception that is thrown when a specified event provider name references a disabled event provider. Отключенный поставщик событий не может публиковать события.A disabled event provider cannot publish events.

EventLogQuery

Представляет запрос для событий в журнале событий и параметры, определяющие метод выполнения запроса и компьютер, на котором запрос будет выполнен.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

Позволяет считывать события из журнала событий в соответствии с запросом события.Enables you to read events from an event log based on an event query. События, считываемые данным объектом, возвращаются в качестве объектов EventRecord.The events that are read by this object are returned as EventRecord objects.

EventLogReadingException

Представляет исключение, происходящее при возникновении ошибки в процессе чтения, запроса или подписки на события в журнале событий.Represents an exception that is thrown when an error occurred while reading, querying, or subscribing to the events in an event log.

EventLogRecord

Содержит свойства экземпляра событий для события, принятого от объекта EventLogReader.Contains the properties of an event instance for an event that is received from an EventLogReader object. Свойства события предоставляют информацию о событии (например, имя компьютера, на котором было зарегистрировано событие и время создания события).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

Используется для доступа к службе журнала событий на локальном компьютере или удаленном компьютере, что обеспечивает возможность управления и сбора информации о журналах событий и поставщиках событий на компьютере.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

Содержит код состояния или код ошибки для определенного журнала событий.Contains the status code or error code for a specific event log. Данное состояние может использоваться для определения доступности журнала событий для операций.This status can be used to determine if the event log is available for an operation.

EventLogWatcher

Позволяет подписаться на входящие события.Allows you to subscribe to incoming events. Каждый раз при публикации требуемого события в журнале событий вызывается событие EventRecordWritten и выполняется метод, обрабатывающий данное событие.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

Содержит метаданные (свойства и параметры) для события, определенного в поставщике событий.Contains the metadata (properties and settings) for an event that is defined in an event provider.

EventOpcode

Содержит код операций события, определенный в поставщике событий.Contains an event opcode that is defined in an event provider. Код операций определяет числовое значение, идентифицирующее действие или пункт действия, который выполнялся приложением при вызове события.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

Содержит значение свойства события, указанное поставщиком событий при публикации события.Contains the value of an event property that is specified by the event provider when the event is published.

EventRecord

Определяет свойства экземпляра событий для события, принятого от объекта EventLogReader.Defines the properties of an event instance for an event that is received from an EventLogReader object. Свойства события предоставляют информацию о событии (например, имя компьютера, на котором было зарегистрировано событие и время создания события).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. Этот класс является абстрактным классом.This class is an abstract class. Класс EventLogRecord реализует данный класс.The EventLogRecord class implements this class.

EventRecordWrittenEventArgs

При вызове события EventRecordWritten экземпляр данного объекта передается методу делегата, обрабатывающему событие.When the EventRecordWritten event is raised, an instance of this object is passed to the delegate method that handles the event. Данный объект содержит событие, опубликованное в журнале событий или исключение, произошедшее при сбое подписки на событие.This object contains the event that was published to the event log or the exception that occurred when the event subscription failed.

EventTask

Содержит задачу события, определенную в поставщике событий.Contains an event task that is defined in an event provider. Задача идентифицирует часть приложения или компонента, публикующего событие.The task identifies a portion of an application or a component that publishes an event. Задача является 16-разрядным значением, 16 верхних значений зарезервированы.A task is a 16-bit value with 16 top values reserved.

ProviderMetadata

Содержит статическую информацию о поставщике событий (например, имя и идентификатор поставщика), а также коллекцию событий, определенных в поставщике.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.

Перечисления

EventLogIsolation

Определяет права доступа по умолчанию для журнала событий.Defines the default access permissions for the event log. Значение приложения и системы указывают, что журнал использует список управления доступом (ACL) совместно с соответствующим журналом Windows (журнал событий приложения или системы), а также совместно использует сеанс трассировки событий Windows (ETW) с другими журналами одной изоляции.The Application and System values indicate that the log shares the access control list (ACL) with the appropriate Windows log (the Application or System event logs) and share the Event Tracing for Windows (ETW) session with other logs of the same isolation. Все каналы с пользовательской изоляцией используют закрытый сеанс ETW.All channels with Custom isolation use a private ETW session.

EventLogMode

Определяет поведение при обработке службой журнала событий журнала событий при достижении максимального размера (при заполнении журнала событий).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

Определяет тип событий, регистрируемых в журнале событий. Каждый журнал может содержать только один тип события.Each log can only contain one type of event.

PathType

Указывает, что строка содержит: имя журнала события или путь к файлу журнала события.Specifies that a string contains a name of an event log or the file system path to an event log file.

SessionAuthentication

Определяет значения для типа проверки подлинности, используемого при удаленном вызове процедуры (RPC) входа на сервер. Вход в систему происходит таким образом при создании объекта EventLogSession, указывающего подключение к удаленному компьютеру.This login occurs when you create a EventLogSession object that specifies a connection to a remote computer.

StandardEventKeywords

Определяет стандартные ключевые слова, вложенные в событие поставщиком событий.Defines the standard keywords that are attached to events by the event provider. Дополнительные сведения о ключевых словах см. в разделе EventKeyword.For more information about keywords, see EventKeyword.

StandardEventLevel

Определяет стандартные уровни событий, используемые службой журнала событий. Уровень определяет серьезность события. Пользовательские уровни события могут определяться вне зависимости от данных стандартных уровней. Дополнительные сведения об уровнях см. в разделе EventLevel.For more information about levels, see EventLevel.

StandardEventOpcode

Определяет стандартные коды операций, вложенные в событие поставщиком событий. Дополнительные сведения о кодах операций см. в разделе EventOpcode.For more information about opcodes, see EventOpcode.

StandardEventTask

Определяет стандартные задачи, вложенные в событие поставщиком событий. Дополнительные сведения о задачах см. в разделе EventTask.For more information about tasks, see EventTask.