TraceSwitch コンストラクター

定義

名前空間:

System.Diagnostics

アセンブリ:

System.Diagnostics.TraceSource.dll

TraceSwitch クラスの新しいインスタンスを初期化します。

オーバーロード

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

TraceSwitch(String, String)

ソース:

TraceSwitch.cs

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

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

public TraceSwitch (string displayName, string? description);

new System.Diagnostics.TraceSwitch : string * string -> System.Diagnostics.TraceSwitch

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

パラメーター

displayName

String

ユーザー インターフェイスに表示される名前。

description

String

スイッチの説明。

例

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

   // 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.*/
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();
}

' 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

注釈

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

<configuration>  
  <system.diagnostics>  
    <switches>  
      <add name="mySwitch" value="1" />  
    </switches>  
  </system.diagnostics>  
</configuration>  

テキストを使用してスイッチの値を指定することもできます。 たとえば、 true の 場合BooleanSwitchや、 などのError列挙値を表すテキスト。TraceSwitch <add name="mySwitch" value="Error" /> という行は、<add name="mySwitch" value="1" /> と同じです。

アプリケーションでは、次の例に示すように、同じ名前の を TraceSwitch 作成することで、構成されたスイッチ レベルを使用できます。

private:
    static TraceSwitch^ appSwitch = gcnew TraceSwitch("mySwitch",
        "Switch in config file");

public:
    static void Main(array<String^>^ args)
    {
        //...
        Console::WriteLine("Trace switch {0} configured as {1}",
        appSwitch->DisplayName, appSwitch->Level.ToString());
        if (appSwitch->TraceError)
        {
            //...
        }
    }

private static TraceSwitch appSwitch = new TraceSwitch("mySwitch",
    "Switch in config file");

public static void Main(string[] args)
{
    //...
    Console.WriteLine("Trace switch {0} configured as {1}",
    appSwitch.DisplayName, appSwitch.Level.ToString());
    if (appSwitch.TraceError)
    {
        //...
    }
}

Private Shared appSwitch As new TraceSwitch("mySwitch", _
    "Switch in config file")

Public Shared Sub Main(args As String())
    '...
    Console.WriteLine("Trace switch {0} configured as {1}",
    appSwitch.DisplayName, appSwitch.Level.ToString())
    If appSwitch.TraceError = True  Then
        '...
    End If
End Sub

このコンストラクターは、 Level 新しいスイッチの プロパティを に TraceLevel.Off設定します。 または、.NET Framework アプリの場合、スイッチ設定は構成ファイルから取得されます (使用可能な場合)。

クラスにはTraceSwitch、スイッチの をTraceErrorTraceWarningテストLevelするための、、TraceInfo、および TraceVerbose の各プロパティが用意されています。 プロパティは Level 、スイッチ TraceLevelの を取得または設定します。

注意

パフォーマンスを向上させるために、クラスのメンバーstaticを作成TraceSwitchできます。

こちらもご覧ください

• TraceSwitch
• TraceLevel
• Switch
• Debug
• Trace

TraceSwitch(String, String, String)

ソース:

TraceSwitch.cs

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

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

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

new System.Diagnostics.TraceSwitch : string * string * string -> System.Diagnostics.TraceSwitch

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

パラメーター

displayName

String

ユーザー インターフェイスに表示される名前。

description

String

スイッチの説明。

defaultSwitchValue

String

スイッチの既定値。

注釈

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