SourceSwitch Класс

Определение

Пространство имен:

System.Diagnostics

Сборка:

System.Diagnostics.TraceSource.dll

Исходный код:

SourceSwitch.cs

Предоставляет многоуровневый переключатель для управления выводом трассировки и отладки без повторной компиляции кода.

public ref class SourceSwitch : System::Diagnostics::Switch

public class SourceSwitch : System.Diagnostics.Switch

type SourceSwitch = class
    inherit Switch

Public Class SourceSwitch
Inherits Switch

Наследование

Object

Switch

SourceSwitch

Комментарии

Свойство SwitchTraceSource класса является SourceSwitch объектом . Класс SourceSwitch предоставляет Level свойство для проверки уровня событий переключателя. Свойство Level получает или задает значение переключателя TraceLevel .

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

Чтобы настроить SourceSwitch, измените файл конфигурации, соответствующий имени приложения. В этом файле можно задать значение переключателя или очистить все параметры, ранее заданные приложением. Файл конфигурации должен быть отформатирован, как показано в следующем примере.

<switches>  
  <add name="SourceSwitch" value="Verbose"></add>  
</switches>  

Параметр используется для проверка, следует ли распространять или игнорировать трассировку. Каждый TraceSource метод трассировки ShouldTrace вызывает метод перед вызовом прослушивателей. ShouldTrace Если метод возвращает falseзначение , трассировка игнорируется, а метод трассировки завершается. ShouldTrace Если метод возвращает true, трассировка передается прослушивателям.

Конструкторы

SourceSwitch(String)	Инициализирует новый экземпляр класса SourceSwitch, задающего имя источника.
SourceSwitch(String, String)	Выполняет инициализацию нового класса SourceSwitch, задающего для переключателя источника отображаемое имя и значение по умолчанию.

Свойства

Attributes	Получает настраиваемые атрибуты переключателя, определенные в файле конфигурации приложения. (Унаследовано от Switch)
DefaultValue	Возвращает значение по умолчанию, назначенное в конструкторе . (Унаследовано от Switch)
Description	Получает описание переключателя. (Унаследовано от Switch)
DisplayName	Получает имя, идентифицирующее переключатель. (Унаследовано от Switch)
Level	Получает или задает уровень переключателя.
SwitchSetting	Получает или задает текущее положение данного переключателя. (Унаследовано от Switch)
Value	Получает или задает значение переключателя. (Унаследовано от Switch)

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetSupportedAttributes()	Возвращает настраиваемые атрибуты, поддерживаемые переключателем. (Унаследовано от Switch)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
OnSwitchSettingChanged()	Вызывается при изменении свойства SwitchSetting. (Унаследовано от Switch)
OnValueChanged()	Вызывается при изменении значения свойства Value.
Refresh()	Обновляет данные конфигурации трассировки. (Унаследовано от Switch)
ShouldTrace(TraceEventType)	Позволяет определить на основе типа трассировки, нужно ли вызывать прослушивателей трассировки.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)