Пошаговое руководство. Фильтрация вывода My.Application.Log (Visual Basic)
В этом пошаговом руководстве демонстрируется изменение фильтрации журнала по умолчанию для объекта My.Application.Log, управление передачей информации из объекта Log в прослушиватели и управление информацией, записываемой прослушивателями. Режим записи в журнал можно изменить и после создания приложения, поскольку сведения о конфигурации хранятся в файле конфигурации приложения.
Приступая к работе
Каждое сообщение, записываемое объектом My.Application.Log, имеет соответствующий уровень серьезности, который можно использовать в механизмах фильтрации для управления выводом в журнал. Этот пример приложения использует методы My.Application.Log для записи в журнал нескольких сообщений с различными уровнями серьезности.
Чтобы создать пример приложения |
|
Сведения о просмотре окна отладочного вывода приложения см. в разделе Окно выходных данных. Сведения о расположении файла журнала приложения см. в разделе Пошаговое руководство. Определение места записи информации для My.Application.Log (Visual Basic).
Примечание
По умолчанию приложение записывает вывод в файл журнала во время закрытия приложения.
В приведенном выше примере второй вызов метода WriteEntry и вызов метода WriteException формируют вывод в журнал, а первый и последний вызовы метода WriteEntry — нет. Это обусловлено тем, что методы WriteEntry WriteException имеют уровни серьезности "Information" и "Error", которые разрешены при фильтрации журнала по умолчанию объекта My.Application.Log. Однако события с уровнями важности "Start" и "Stop" не выводятся в журнал.
Фильтрация для всех прослушивателей My.Application.Log
Объект My.Application.Log использует объект типа SourceSwitch с именем DefaultSwitch для управления передачей сообщений методами WriteEntry WriteException в прослушиватели журнала. В файле конфигурации приложения можно настроить DefaultSwitch, присвоив его значениям одно из значений перечисления SourceLevels. По умолчанию его значение равно "Information".
В следующей таблице показан уровень серьезности, необходимый для записи сообщений в прослушиватели, с учетом значения параметра DefaultSwitch.
Значение DefaultSwitch |
Уровень серьезности сообщения, необходимый для вывода |
Critical |
Critical |
Error |
Critical или Error |
Warning |
Critical, Error или Warning |
Information |
Critical, Error, Warning или Information |
Verbose |
Critical, Error, Warning, Information или Verbose |
ActivityTracing |
Start, Stop, Suspend, Resume или Transfer |
All |
Разрешены все сообщения. |
Off |
Заблокированы все сообщения. |
Примечание
Каждый из методов WriteEntry и WriteException имеет перегрузки, в которых не указан уровень серьезности.Неявный уровень серьезности для перегрузки WriteEntry — уровень "Information", а для перегрузки WriteException — уровень "Error".
Эта таблица объясняет журнала результат, показанный в предыдущем примере: по умолчанию DefaultSwitch установка «Информации», только второй вызов WriteEntry метод и призыв к WriteException вывод журнала метода производства.
Чтобы протоколировать только события отслеживания действий |
|
Примечание
Параметр переключения DefaultSwitch влияет только на объект My.Application.Log.Он не влияет на поведение классов .NET Framework System.Diagnostics.Trace и System.Diagnostics.Debug.
Индивидуальная фильтрация для прослушивателей My.Application.Log
В предыдущем примере показано, как изменить фильтрацию для всего вывода объекта My.Application.Log. В этом примере демонстрируется способ фильтрации для отдельных прослушивателей журнала. По умолчанию приложение имеет два прослушивателя, которые выполняют запись в вывод отладки и файл журнала.
Файл конфигурации управляет поведением прослушивателей журнала, позволяя каждому из них иметь фильтр, аналогичный переключателю My.Application.Log. Прослушиватель журнала будет выводить сообщение, только если уровень его серьезности разрешен параметром DefaultSwitch журнала и фильтром прослушивателя журнала.
В этом примере демонстрируется настройка фильтрации для нового прослушивателя отладки и добавление его в объект Log. Прослушиватели отладки по умолчанию необходимо удалить из объекта Log, чтобы обеспечить поступление сообщений отладки только из нового прослушивателя отладки.
Чтобы протоколировать только события отслеживания действий |
|
Дополнительные сведения об изменении параметров журнала после развертывания см. в разделе Работа с журналами приложения в Visual Basic.
См. также
Задачи
Пошаговое руководство. Определение места записи информации для My.Application.Log (Visual Basic)
Пошаговое руководство. Изменение места записи информации для My.Application.Log (Visual Basic)
Пошаговое руководство. Создание пользовательских прослушивателей журнала (Visual Basic)
Практическое руководство. Запись сообщений в журнал (Visual Basic)