TraceSwitch コンストラクタとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

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

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

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim displayName As String
Dim description As String
Dim defaultSwitchValue As String

Dim instance As New TraceSwitch(displayName,
 description, defaultSwitchValue)

public TraceSwitch (
    string displayName,
    string description,
    string defaultSwitchValue
)

C++

public:
TraceSwitch (
    String^ displayName, 
    String^ description, 
    String^ defaultSwitchValue
)

public TraceSwitch (
    String displayName, 
    String description, 
    String defaultSwitchValue
)

JScript

public function TraceSwitch (
    displayName : String, 
    description : String, 
    defaultSwitchValue : String
)

パラメータ

displayName: ユーザーインターフェイスで表示する名前。

description: スイッチの説明。

defaultSwitchValue: スイッチの既定値。

解説

displayName パラメータは DisplayName プロパティの値の設定、description パラメータは Description プロパティの値の設定に使用され、defaultSwitchValue パラメータはフィールドとして保存されて Value プロパティを初期化するために最初の参照で使用されます。コード例および詳細については、TraceSwitch(String,String) コンストラクタのトピックを参照してください。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TraceSwitch クラス
TraceSwitch メンバ
System.Diagnostics 名前空間

TraceSwitch コンストラクタ

TraceSwitch クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
TraceSwitch (String, String)	表示名と説明を指定して、TraceSwitch クラスの新しいインスタンスを初期化します。
TraceSwitch (String, String, String)	スイッチの表示名、説明、および既定値を指定して、TraceSwitch クラスの新しいインスタンスを初期化します。

参照

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

表示名と説明を指定して、TraceSwitch クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    displayName As String, _
    description As String _
)

Visual Basic (使用法)

Dim displayName As String
Dim description As String

Dim instance As New TraceSwitch(displayName,
 description)

public TraceSwitch (
    string displayName,
    string description
)

C++

public:
TraceSwitch (
    String^ displayName, 
    String^ description
)

public TraceSwitch (
    String displayName, 
    String description
)

JScript

public function TraceSwitch (
    displayName : String, 
    description : String
)

パラメータ

displayName: ユーザーインターフェイスで表示する名前。

description: スイッチの説明。

解説

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

<configuration>
  <system.diagnostics>
    <switches>
      <add name="mySwitch" value="0" />
      <add name="myNewSwitch" value="3" />
      <remove name="mySwitch" />
      <clear/>
    </switches>
  </system.diagnostics>
</configuration>

TraceSwitch コンストラクタが、構成ファイルの初期スイッチ設定を検出できない場合は、新しいスイッチの Level プロパティが TraceLevel.Off に設定されます。

TraceSwitch クラスは、スイッチの Level をテストする TraceError、TraceWarning、TraceInfo、および TraceVerbose の各プロパティを提供します。Level プロパティは、スイッチの TraceLevel を取得または設定します。

メモ
クラスの TraceSwitch のメンバを static にすることで、パフォーマンスを向上させることができます。

使用例

新しい TraceSwitch を作成し、スイッチを使用してエラーメッセージを出力するかどうかを決定するコード例を次に示します。スイッチはクラスレベルで作成されます。MyMethod は、Level プロパティが TraceLevel.Error 以上に設定されている場合に最初のエラーメッセージを書き込みます。ただし、MyMethod は、Level が TraceLevel.Verbose 未満の場合は第 2 のエラーメッセージを書き込みません。

Visual Basic

' Class-level declaration.
' Create a TraceSwitch to use in the entire application. 
Private Shared mySwitch As
 New TraceSwitch("General", "Entire
 Application")    

Public Shared Sub MyMethod()
    ' Write the message if the TraceSwitch level is set to Error or
 higher.
    If mySwitch.TraceError Then
        Console.WriteLine("My error message.")
    End If 
    ' Write the message if the TraceSwitch level is set to Verbose.
    If mySwitch.TraceVerbose Then
        Console.WriteLine("My second error message.")
    End If
End Sub

Public Shared Sub Main()
    ' Run the method that prints error messages based on the switch
 level.
    MyMethod()
End Sub

//Class-level declaration.
 /* Create a TraceSwitch to use in the entire application.*/
 static TraceSwitch mySwitch = new TraceSwitch("General",
 "Entire Application");
 
 static public void MyMethod()
 {
    // Write the message if the TraceSwitch level is set to Error or
 higher.
    if(mySwitch.TraceError)
       Console.WriteLine("My error message.");
 
    // Write the message if the TraceSwitch level is set to Verbose.
    if(mySwitch.TraceVerbose)
       Console.WriteLine("My second error message.");
 }
 
 public static void Main(string[]
 args) {
    // Run the method that prints error messages based on the switch
 level.
    MyMethod();
 }

C++

   // Class-level declaration.
   /* Create a TraceSwitch to use in the entire application.*/
private:
   static TraceSwitch^ mySwitch = gcnew TraceSwitch( "General",
 "Entire Application" );

public:
   static void MyMethod()
   {
      // Write the message if the TraceSwitch level is set to Error or
 higher.
      if ( mySwitch->TraceError )
         Console::WriteLine( "My error message." );
      
      // Write the message if the TraceSwitch level is set to Verbose.
      if ( mySwitch->TraceVerbose )
         Console::WriteLine( "My second error message." );
   }

   static void main()
   {
      // Run the method that prints error messages based on the switch
 level.
      MyMethod();
   }

// Class-level declaration.
/* Create a TraceSwitch to use in the entire application.
 */
private static TraceSwitch mySwitch =
    new TraceSwitch("General", "Entire Application");

public static void MyMethod()
{
    //Write the message if the TraceSwitch level is set to Error or
 higher.
    if (mySwitch.get_TraceError()) {
        Console.WriteLine("My error message.");
    }

    // Write the message if the TraceSwitch level is set to Verbose.
    if (mySwitch.get_TraceVerbose()) {
        Console.WriteLine("My second error message.");
    }
} //MyMethod

public static void main(String[]
 args)
{
    // Run the method that prints error messages based on the switch
 level.
    MyMethod();
} //main