SourceSwitch 類別

定義

命名空間:

System.Diagnostics

組件:

System.Diagnostics.TraceSource.dll

來源:

SourceSwitch.cs

提供多層切換控制追蹤與偵錯的輸出，而不需要重新編譯程式碼。

C#

public class SourceSwitch : System.Diagnostics.Switch

繼承

Object

Switch

SourceSwitch

備註

類別 Switch 的 TraceSource 屬性是 SourceSwitch 物件。 類別 SourceSwitch 提供 Level 屬性來測試參數的事件層級。 屬性 Level 會取得或設定參數 TraceLevel 的值。

您可以透過應用程式組態檔設定 的事件層級 SourceSwitch ，然後在應用程式中使用設定 SourceSwitch 的層級。 或者，您可以在程式代碼中建立 ， SourceSwitch 並直接設定層級，以檢測程式代碼的特定區段。

若要設定 SourceSwitch，請編輯對應至應用程式名稱的組態檔。 在此檔案中，您可以設定參數的值，或清除應用程式先前設定的所有參數。 組態檔的格式應該如下列範例所示。

XML

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

適用於