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) |