Программная архитектура компонента EventLog
Обновлен: Ноябрь 2007
Компонент EventLog использует следующие части пространств имен .NET Framework:
Пространство имен EventLog
.gif "Пространство имен журнала событий")
При добавлении в приложение экземпляра компонента EventLog система Visual Studio автоматически создает ссылки и операторов импорта, которые необходимы для доступа к пространству имен и классам. Однако если компоненты EventLog создаются в коде или в Microsoft .NET Framework, может потребоваться создание ссылки на пространство имен System.Diagnostics и добавление в проект оператора для импорта соответствующей библиотеки.
Инструкции по добавлению и удалению ссылок в проекте см. в разделе Практическое руководство. Добавление или удаление ссылок в Visual Studio (Visual Basic).
Основные элементы программирования класса EventLog
Компонент EventLog вызывает событие с именем EntryWritten каждый раз при добавлении записи в журнал, за которым ведется наблюдение. Для этого события можно определить обработчика. Кроме того, для взаимодействия с экземпляром компонента EventLog можно использовать следующие методы:
Для проверки существования определенного журнала событий можно использовать метод Exists.
Метод CreateEventSource можно использовать для определения строки, которая устанавливает связь между источником события и журналом, а для удаления данной связи используется метод DeleteEventSource. Этот метод также можно использовать для создания пользовательских журналов событий. Просто введите новое имя журнала, в котором нужно создать источник, и система создаст журнал автоматически.
.gif "Примечание")
Примечание.Свойство Source можно задать для любой строки; это свойство может не совпадать с именем приложения. Одно приложение может содержать несколько компонентов, использующих разные исходные строки, по которым данные компоненты идентифицируются в журналах событий.
Метод WriteEntry служит для записи информации о событиях в любой журнал событий, к которому имеется доступ. Метод WriteEntry автоматически регистрирует компонент или приложение в качестве допустимого источника, если этот источник еще не зарегистрирован в указанном журнале.
Метод SourceExists позволяет определить, зарегистрирован ли уже конкретный источник или нет. Это может потребоваться при создании нового источника на компьютере, поскольку метод SourceExists вызовет ошибку времени выполнения, если источник на данном компьютере уже зарегистрирован.
Для извлечения списка всех журналов событий на определенном компьютере можно использовать метод GetEventLogs.
Метод Delete используется для удаления журнала событий целиком. Этот метод следует использовать с осторожностью, поскольку при удалении журнала удаляются все зарегистрированные в нем источники.