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) |
適用対象
.NET