SourceSwitch クラス

.NET Framework クラス ライブラリ リファレンス

SourceSwitch クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

コードを再コンパイルせずに、トレースやデバッグの出力を制御する複数レベルのスイッチを提供します。

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Class SourceSwitch
    Inherits Switch

Visual Basic (使用法)

Dim instance As SourceSwitch

C#

public class SourceSwitch : Switch

C++

public ref class SourceSwitch : public
 Switch

J#

public class SourceSwitch extends Switch

JScript

public class SourceSwitch extends
 Switch

解説

TraceSource クラスの Switch プロパティは、SourceSwitch オブジェクトです。SourceSwitch クラスは、スイッチのイベント レベルをテストする Level プロパティを提供します。Level プロパティは、スイッチの TraceLevel 値を取得または設定します。

アプリケーション構成ファイルで SourceSwitch のイベント レベルを設定し、構成した SourceSwitch レベルをアプリケーションで使用できます。または、SourceSwitch をコード内に作成し、レベルを直接設定してコードの特定のセクションをインストルメントすることもできます。

SourceSwitch を構成するには、アプリケーションの名前に対応した構成ファイルを編集します。このファイルでは、スイッチの値の設定や、アプリケーションで以前設定されたすべてのスイッチのクリアを実行できます。構成ファイルの書式は次の例のようになります。

<switches>
  <add name="SourceSwitch" value="Verbose"></add>
</switches>

スイッチは、トレースを反映するか、または無視するかを確認するために使用されます。各 TraceSource トレース メソッドは、リスナを呼び出す前に ShouldTrace メソッドを呼び出します。ShouldTrace メソッドが false を返した場合、トレースは無視され、トレース メソッドは終了します。ShouldTrace メソッドが true を返した場合、トレースはリスナに渡されます。

Topic	Location
方法 : トレース スイッチを作成し初期化する	.NET Framework: デバッグ
方法 : トレース スイッチを設定する	.NET Framework: デバッグ

継承階層

System.Object
   System.Diagnostics.Switch
    System.Diagnostics.SourceSwitch

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SourceSwitch メンバ
System.Diagnostics 名前空間