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


Практическое руководство. Создание и инициализация переключателей трассировки

Чтобы использовать переключатели трассировки, их необходимо сначала создать и вставить в код. Существуют два предварительно определенных класса, с помощью которых можно создать объекты переключателей: BooleanSwitch и TraceSwitch. Класс BooleanSwitch используется в том случае, когда требуется определить лишь возможность отображения сообщений трассировки; класс TraceSwitch применяется при необходимости разграничить уровни трассировки. При использовании класса TraceSwitch можно определить собственные сообщения отладки и связать их с различными уровнями трассировки. Оба типа переключателей можно использовать как с трассировкой, так и с отладкой. По умолчанию класс BooleanSwitch отключен, а для класса TraceSwitch установлен уровень TraceLevel.Off. Переключатели трассировки можно создавать и помещать в любом участке кода, где возможно их использование.

Хотя допускается настройка уровней трассировки и других параметров конфигурации непосредственно в коде, для управления состоянием переключателей рекомендуется использовать файл конфигурации. Управление настройкой параметров в системе конфигурации обеспечивает большую гибкость — возможность включать и отключать различные переключатели и изменять уровни без перекомпиляции приложения. Дополнительные сведения см. в разделе Настройка переключателей трассировки.

Создание и инициализация переключателей трассировки

  1. Необходимо определить тип переключателя (BooleanSwitch или TraceSwitch) и задать его имя и описание.

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

    В приведенном ниже примере кода создаются два переключателя различного типа.

    Dim dataSwitch As New BooleanSwitch("Data", "DataAccess module")
    Dim generalSwitch As New TraceSwitch("General", "Entire application")
    
    System.Diagnostics.BooleanSwitch dataSwitch = 
       new System.Diagnostics.BooleanSwitch("Data", "DataAccess module");
    System.Diagnostics.TraceSwitch generalSwitch = 
       new System.Diagnostics.TraceSwitch("General", 
       "Entire application");
    

См. также

Задачи

Практическое руководство. Конфигурация переключателей трассировки

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

Переключатели трассировки

Введение. Подготовка к инструментированию и трассировка.