SourceSwitch 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
提供多级开关，用于控制跟踪和调试输出，而无需重新编译代码。
public ref class SourceSwitch : System::Diagnostics::Switchpublic class SourceSwitch : System.Diagnostics.Switchtype SourceSwitch = class
inherit SwitchPublic Class SourceSwitch
Inherits Switch- 继承
注解
Switch类的 TraceSource 属性是 对象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) |
