SourceSwitch 類別

  • 參考

定義

命名空間:
System.Diagnostics
組件:
System.Diagnostics.TraceSource.dll
組件:
System.dll
組件:
netstandard.dll

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

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)
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 屬性的值變更時叫用。
ShouldTrace(TraceEventType)

根據追蹤事件型別，判斷是否應該呼叫追蹤接聽程式。
ToString()

傳回代表目前物件的字串。

(繼承來源 Object)

適用於