SourceSwitch Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет многоуровневый переключатель для управления выводом трассировки и отладки без повторной компиляции кода.
public ref class SourceSwitch : System::Diagnostics::Switch
public class SourceSwitch : System.Diagnostics.Switch
type SourceSwitch = class
inherit Switch
Public Class SourceSwitch
Inherits Switch
- Наследование
Комментарии
Свойство 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) |