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

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

Чтобы компонент получил возможность добавлять записи в журнал событий, необходимо зарегистрировать его в данном журнале в качестве разрешенного источника событий. Для этого используется метод CreateEventSource с указанием строки, однозначно идентифицирующей компонент в журнале событий. При добавлении записи в журнал событий система использует указанный источник для поиска журнала, в который необходимо ее добавить. Экземпляр компонента EventLog может одновременно добавлять записи только в один журнал.

Примечание.

По умолчанию при попытке добавить запись в журнал без предварительной регистрации компонента в качестве разрешенного источника система автоматически регистрирует его в этом журнале, используя свойство Source в качестве строки источника. Вообще, при установке приложения следует создавать новый источник события. Благодаря этому операционная система успевает обновить свой список зарегистрированных источников событий и их конфигурацию. Если список источников событий в системе не обновился и предпринимается попытка записать событие с новым источником, возникнет ошибка выполнения операции записи. Если создание источника во время установки невозможно, можно попытаться создать его задолго до первой операции записи, возможно, при инициализации приложения. При выборе этого способа следует убедиться, что код инициализации выполняется с правами администратора. Они необходимы для создания новых источников событий.

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

Источник событий с локализованными ресурсами можно зарегистрировать для категории событий и строк сообщения. Для внесения записей в журнал событий в приложении вместо указания фактических значений строк используются идентификаторы ресурсов. Дополнительные сведения о настройке источника с файлами ресурсов см. в описании классов EventLogInstaller и EventSourceCreationData.

Определение компонента в качестве источника событий

• Для создания записей на локальном компьютере вызовите метод CreateEventSource и укажите строку источника и имя журнала в качестве параметров.

  Примечание.
  Если в качестве имени журнала указано пустое значение (« "), по умолчанию оно будет Application.

  В следующем примере показано, как зарегистрировать компонент MyApp1 в качестве источника событий для журнала приложений. В этом коде предполагается, что для пространства имен System.Diagnostics существует инструкция Imports или using.

  EventLog.CreateEventSource("MyApp1", "Application")
  

       System.Diagnostics.EventLog.CreateEventSource("MyApp1", "Application");
  

  Совет.
  Для создания источника событий на удаленном компьютере используйте компонент EventSourceCreationData. В следующем коде приведен пример:

  Dim creationData As New EventSourceCreationData("ApplicationName", "Application")
  creationData.MachineName = "ServerName"
  EventLog.CreateEventSource(creationData)
  

       System.Diagnostics.EventSourceCreationData creationData = new
              System.Diagnostics.EventSourceCreationData("ApplicationName", "Application");
          creationData.MachineName = "ServerName";
          EventLog.CreateEventSource(creationData);
  

См. также

Задачи

Практическое руководство. Определение существования источника события

Практическое руководство. Удаление источника событий

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

Пошаговое руководство. Работа с журналами событий, источниками событий и записями

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

Знакомство с компонентом EventLog

Ссылки

EventLog