Trace クラス

定義

public ref class Trace sealed

public sealed class Trace

type Trace = class

Public NotInheritable Class Trace

継承

Object

Trace

例

次の例では、 を使用 Trace して、プログラムの実行の開始と終了を示します。 この例では、 メソッドと Trace.Unindent メソッドを使用Trace.Indentしてトレース出力を区別します。 の使用 Trace例の詳細については、「 方法: アプリケーション コードにトレース ステートメントを追加する」を参照してください。

// Specify /DTRACE when compiling.

#using <System.dll>
using namespace System;
using namespace System::Diagnostics;

int main()
{
   #if defined(TRACE)
   Trace::Listeners->Add( gcnew TextWriterTraceListener( Console::Out ) );
   Trace::AutoFlush = true;
   Trace::Indent();
   Trace::WriteLine( "Entering Main" );
   #endif
   Console::WriteLine( "Hello World." );
   #if defined(TRACE)
   Trace::WriteLine( "Exiting Main" );
   Trace::Unindent();
   #endif
   return 0;
}

// Specify /d:TRACE when compiling.

using System;
using System.Diagnostics;

class Test
{
    static void Main()
    {
       Trace.Listeners.Add(new TextWriterTraceListener(Console.Out));
       Trace.AutoFlush = true;
       Trace.Indent();
       Trace.WriteLine("Entering Main");
       Console.WriteLine("Hello World.");
       Trace.WriteLine("Exiting Main");
       Trace.Unindent();
    }
}

' Specify /d:TRACE=True when compiling.

Imports System.Diagnostics

Class Test
    
    Shared Sub Main()
    
        Trace.Listeners.Add(New TextWriterTraceListener(Console.Out))
        Trace.AutoFlush = True
        Trace.Indent()
        Trace.WriteLine("Entering Main")
        Console.WriteLine("Hello World.")
        Trace.WriteLine("Exiting Main")
        Trace.Unindent()
        
    End Sub

End Class

注釈

クラスのプロパティとメソッドを使用して、 Trace リリース ビルドをインストルメント化できます。 インストルメンテーションを使用すると、実際の設定で実行されているアプリケーションの正常性を監視できます。 トレースを使用すると、実行中のシステムを妨げることなく、問題を分離して修正できます。

このクラスは、ダイアログ ボックスを Assert 表示し、常 Failに を行うアサーションを出力するメソッドを提供します。 このクラスは、次のバリエーションの書き込みメソッドを提供します。

• Write
• WriteLine
• WriteIf
• WriteLineIf

クラスと TraceSwitch クラスはBooleanSwitch、トレース出力を動的に制御する手段を提供します。 .NET Framework アプリでは、アプリケーションを再コンパイルすることなく、これらのスイッチの値を変更できます。 構成ファイルを使用して.NET Framework アプリでスイッチを設定する方法については、クラスと方法: Create、初期化、およびトレース スイッチの構成に関するページを参照してくださいSwitch。

インスタンスをコレクションに追加 TraceListener するか、コレクションからインスタンスを削除することで、トレース出力のターゲットを Listeners カスタマイズできます。 コレクションはListeners、 クラスと クラスのTrace両方Debugで共有されます。いずれかのクラスにトレース リスナーを追加すると、リスナーが両方に追加されます。 既定では、 クラスを使用して DefaultTraceListener トレース出力が出力されます。

クラスは Trace 、 および の Indent レベルを取得または設定するためのプロパティと、 IndentSize各書き込みの後に を に AutoFlush するかどうかを提供します。

.NET Framework アプリでは、アプリケーションの名前にAutoFlush対応する構成ファイルを編集することで、 と IndentSizeTrace を設定できます。 構成ファイルは、次の例のように書式設定する必要があります。

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="3" />  
  </system.diagnostics>  
</configuration>  

属性は ConditionalAttribute 、 の メソッド Traceに適用されます。 をサポート ConditionalAttribute するコンパイラは、条件付きコンパイル シンボルとして定義されていない限り TRACE 、これらのメソッドの呼び出しを無視します。 がサポートされているかどうかを ConditionalAttribute 判断するには、コンパイラのドキュメントと、条件付きコンパイル シンボルを定義するための構文を参照してください。

C# で条件付きコンパイル シンボルを TRACE 定義するには、コマンド ラインを /d:TRACE 使用してコードをコンパイルするときにコンパイラ コマンド ラインに オプションを追加するか、ファイルの先頭に を追加 #define TRACE します。 Visual Basic で、コンパイラ コマンド /d:TRACE=True ラインに オプションを追加するか、ファイルに を追加 #Const TRACE=True します。

ConditionalAttribute は C++ コンパイラではサポートされていません。 同等の機能を提供するには、 のメソッド Trace の呼び出しを ブロックで #if defined(TRACE) ... #endif 囲み、 オプションを /DTRACE コンパイラ コマンド ラインに追加するか、ファイルに追加 #define TRACE する必要があります。

プロパティ

メソッド

イベント

適用対象

スレッド セーフ

この型はスレッド セーフです。

こちらもご覧ください

• Debug
• Switch
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• EventLogTraceListener
• TraceListenerCollection
• ConditionalAttribute