SourceSwitch クラス

定義

名前空間:

System.Diagnostics

アセンブリ:

System.Diagnostics.TraceSource.dll

ソース:

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)