SourceSwitchとは? わかりやすく解説

SourceSwitch クラス

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

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

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

Public Class SourceSwitch
    Inherits Switch
public class SourceSwitch : Switch
public ref class SourceSwitch : public
 Switch
public class SourceSwitch extends Switch
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 を返した場合、トレースはリスナに渡されます。

継承階層継承階層
System.Object
   System.Diagnostics.Switch
    System.Diagnostics.SourceSwitch
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

SourceSwitch コンストラクタ (String)

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

ソースの名前を指定して、SourceSwitch クラスの新しいインスタンスを初期化します。

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

public SourceSwitch (
    string name
)
public:
SourceSwitch (
    String^ name
)
public SourceSwitch (
    String name
)
public function SourceSwitch (
    name : String
)

パラメータ

name

ソースの名前。

解説解説
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

SourceSwitch コンストラクタ


SourceSwitch コンストラクタ (String, String)

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

ソース スイッチの表示名および既定値を指定して、SourceSwitch クラスの新しいインスタンスを初期化します。

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

Public Sub New ( _
    displayName As String, _
    defaultSwitchValue As String _
)
Dim displayName As String
Dim defaultSwitchValue As String

Dim instance As New SourceSwitch(displayName,
 defaultSwitchValue)
public SourceSwitch (
    string displayName,
    string defaultSwitchValue
)
public:
SourceSwitch (
    String^ displayName, 
    String^ defaultSwitchValue
)
public SourceSwitch (
    String displayName, 
    String defaultSwitchValue
)
public function SourceSwitch (
    displayName : String, 
    defaultSwitchValue : String
)

パラメータ

displayName

ソース スイッチの名前。

defaultSwitchValue

スイッチの既定値。

解説解説
使用例使用例

"SourceSwitch" という名前で、Verbose の既定値を使用して、SourceSwitch を作成するコード例を次に示します。このコード例は、TraceSource クラスのトピックで取り上げているコード例の一部分です。

#If (ConfigFile = False) Then
            Dim sourceSwitch As New
 SourceSwitch("SourceSwitch", "Verbose")
#End If
#if(!ConfigFile)
                SourceSwitch sourceSwitch = new SourceSwitch("SourceSwitch",
 "Verbose");
#endif
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

SourceSwitch プロパティ


SourceSwitch メソッド


パブリック メソッドパブリック メソッド

プロテクト メソッドプロテクト メソッド
参照参照

関連項目

SourceSwitch クラス
System.Diagnostics 名前空間

SourceSwitch メンバ

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

SourceSwitch データ型で公開されるメンバを以下の表に示します。


パブリック コンストラクタパブリック コンストラクタ
パブリック プロパティパブリック プロパティ
プロテクト プロパティプロテクト プロパティ
パブリック メソッドパブリック メソッド
プロテクト メソッドプロテクト メソッド
参照参照

関連項目

SourceSwitch クラス
System.Diagnostics 名前空間



英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

すべての辞書の索引

「SourceSwitch」の関連用語

SourceSwitchのお隣キーワード

   

英語⇒日本語
日本語⇒英語
   



SourceSwitchのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS