SourceSwitch 类

定义

命名空间:

System.Diagnostics

程序集:

System.Diagnostics.TraceSource.dll

Source:

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

注解

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)