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

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

Для записи информации о событиях, возникающих в приложении, можно использовать объекты My.Application.Log и My.Log. В этом примере показано, как настроить прослушиватель журнала событий, чтобы объект My.Application.Log записывал данные трассировки в журнал событий приложения.

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

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

Примечание.
Журналы событий не поддерживаются в Windows 95, Windows 98 и Windows Millennium Edition.

Добавление и настройка прослушивателя журнала событий

1. Щелкните правой кнопкой мыши файл app.config в Обозревателе решений и выберите команду Открыть.

   или

   Если файл app.config отсутствует:

   1. В меню Проект выберите пункт Добавить новый элемент.

   2. В диалоговом окне Добавление нового элемента выберите Файл конфигурации приложения.

   3. Нажмите кнопку Добавить.

2. Найдите раздел <listeners> в файле конфигурации приложения.

   Вы найдете раздел <listeners>в разделе <source> с атрибутом имени "DefaultSource", вложенным в раздел <system.diagnostics>, который, в свою очередь, вложен в раздел верхнего уровня <configuration>.

3. Добавьте этот элемент в раздел <listeners>.

   <add name="EventLog"/>
   

4. Найдите раздел <sharedListeners> в разделе <system.diagnostics> на верхнем уровне раздела <configuration>.

5. Добавьте этот элемент в раздел <sharedListeners>.

   <add name="EventLog"
       type="System.Diagnostics.EventLogTraceListener, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
        initializeData="APPLICATION_NAME"/>
   

   Замените APPLICATION_NAME именем приложения.

   Примечание.
   Как правило, приложение записывает в журнал событий только ошибки. Сведения о фильтрации выходных данных журнала см. в разделе Пошаговое руководство. Фильтрация вывода My.Application.Log.

Запись информации о событии в журнал событий

• Для записи информации в журнал событий используйте метод My.Application.Log.WriteEntryMy.Application.Log.WriteException. Дополнительные сведения см. в разделах Практическое руководство. Запись сообщений в журнал и Практическое руководство. Запись в журнал сведений об исключениях в Visual Basic.

  После настройки прослушивателя журнала событий для сборки он получает все сообщения, которые записываются объектом My.Applcation.Log из этой сборки.

См. также

Задачи

Практическое руководство. Запись в журнал сведений об исключениях в Visual Basic

Пошаговое руководство. Определение места записи информации для My.Application.Log

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

Работа с журналами приложения в Visual Basic

Ссылки

Объект My.Application.Log

Объект My.Log

Метод WriteEntry (My.Application.Log и My.Log)

Метод WriteException (My.Application.Log и My.Log)