Поделиться через

Практическое руководство. Настройка экземпляров компонента EventLog

  • Статья

Обновлен: Ноябрь 2007

Существует три основных свойства, используемых при настройке экземпляра компонента EventLog.

  • Свойство Log определяет журнал для взаимодействия.

  • Свойство MachineName определяет компьютер, на котором находится рабочий журнал.

  • Свойство Source определяет строку источника, которая будет использоваться для идентификации компонента при добавлении им записи в журнал.

Выбор способа настройки экземпляра компонента EventLog зависит от того, как он будет использоваться.

  • Если нужно добавлять записи в журнал, нужно выполнить одно из следующих действий. Либо зарегистрировать источник с помощью метода CreateEventSource и установить в качестве значения свойства Source компонента EventLog этот же источник, либо задать свойства MachineName, Log, и Source этого компонента.

    w3t54f67.alert_note(ru-ru,VS.90).gifПримечание.

    Задать свойство Log компонента можно напрямую или в коде регистрации компонента в качестве источника событий. Сразу после регистрации компонента в качестве источника устанавливается подключение к реестру сервера, связывающее компонент с выбранным журналом.

  • Если нужно читать записи журнала событий или контролировать их поступление, следует задать свойства MachineName и Log, чтобы указать журнал для просмотра. В этом случае нет необходимости задавать свойство Source.

  • Если нужно, чтобы компонент получал уведомления о событиях EntryWritten, следует задать для EnableRaisingEvents значение true. Дополнительные сведения см. в разделе Практическое руководство. Обработка события EntryWritten.

    В следующем примере показано, как настроить компонент для добавления записей в журнал приложений. В данном случае источник еще не зарегистрирован в журнале, поэтому необходимо указать строку, журнал и имя компьютера. Нет необходимости явно вызывать метод CreateEventSource, поскольку при вызове WriteEntry источник будет зарегистрирован для этого журнала, если это не сделано раньше.

    Dim EventLog1 As New EventLog("Application", "myserver", "newsource")
EventLog1.WriteEntry("Test")

         System.Diagnostics.EventLog EventLog1 = new
           System.Diagnostics.EventLog("Application", "myserver", "newsource");
        EventLog1.WriteEntry("Test");

    Если источник уже был зарегистрирован, можно просто установить свойство Source и добавить свою запись. Например, в следующем коде показано, как добавить запись в журнал, используя уже зарегистрированный источник.

    If Not EventLog.SourceExists("ExistingSourceString") Then
    EventLog.CreateEventSource("ExistingSourceString", "Application")
End If
Dim EventLog1 As New EventLog()
EventLog1.Source = "ExistingSourceString"
EventLog1.WriteEntry("TestEntry2")

         if (!System.Diagnostics.EventLog.SourceExists("ExistingSourceString"))
            System.Diagnostics.EventLog.CreateEventSource(
               "ExistingSourceString", "Application");

        System.Diagnostics.EventLog EventLog1 =
           new System.Diagnostics.EventLog();
        EventLog1.Source = "ExistingSourceString";
        EventLog1.WriteEntry("TestEntry2");
    w3t54f67.alert_note(ru-ru,VS.90).gifПримечание.

    Если свойство MachineName не задано, как показано в этих примерах, будет подразумеваться локальный компьютер.

    Дополнительные сведения об этих свойствах см. в разделе Справочные сведения о журналах событий.

    Записи, извлекаемые из журнала событий, распределяются по нескольким свойствам. Дополнительные сведения об этих свойствах см. в разделе EventLog.

Настройка экземпляра компонента EventLog

  1. Создайте экземпляр компонента EventLog. Дополнительные сведения см. в разделе Практическое руководство. Создание экземпляров компонента EventLog.

  2. Установите нужное сочетание свойств Log, MachineName и Source.

    Задача

    Действия

    Чтение или просмотр журнала событий

    Установите Log и MachineName

    Запись в журнал с помощью новой строки Source

    Установите Source, Log и MachineName

    Запись в журнал для существующего Source

    Задайте в качестве значения свойства Source существующий источник, остальные свойства будут установлены автоматически

  3. Чтобы экземпляр компонента получал уведомления о событии EntryWritten, задайте для свойства EnableRaisingEvents значение true.

См. также

Задачи

Практическое руководство. Создание экземпляров компонента EventLog

Практическое руководство. Добавление приложения в качестве источника записей журнала событий

Практическое руководство. Внесение записей в журналы событий

Основные понятия

Справочные сведения о журналах событий