Trace クラス

定義

コードの実行をトレースするための一連のメソッドとプロパティを提供します。 このクラスは継承できません。

public ref class Trace sealed
public sealed class Trace
type Trace = class
Public NotInheritable Class Trace
継承
Trace

次の例では、を使用して、 Trace プログラムの実行の開始と終了を示します。 また、この例では、メソッドとメソッドを使用して、 Trace.Indent Trace.Unindent トレース出力を区別しています。 の使用方法の詳細な例につい 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 リリースビルドをインストルメント化できます。 インストルメンテーションを使用すると、実際の設定で実行されているアプリケーションの正常性を監視できます。 トレースは、実行中のシステムに支障をきたすことなく、問題を特定して修正するのに役立ちます。

このクラスには、ダイアログボックスを表示するメソッドと、常にのアサーションを生成するメソッドが用意され AssertFail います。 このクラスは、、、 Write WriteLine WriteIf 、およびの各バリエーションで書き込みメソッドを提供します WriteLineIf

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

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

注意

Listeners コレクションにトレース リスナーを追加することで、トレース リスナーによって使用されるリソースが利用できない場合、トレース中に例外を発生させることになります。 条件とスローされる例外は、トレース リスナーに依存し、このトピックで列挙することはできません。 トレース リスナーから例外を検出し、処理するために、Trace メソッドの呼び出しをtry/catchブロックに配置することができます。

注意

トレースリスナーを部分信頼コードに追加すると、例外が発生し SecurityException ます。これは、トレースリスナーを追加するにはアクセス許可が必要であるため UnmanagedCode です。 Visual Studio のサンドボックスで実行されている部分的に信頼されたコードをトレースするには、トレースリスナーを追加しないでください。 代わりに、 Trace Debug 出力 ウィンドウでおよびメッセージを表示します。

クラスには、、、 Trace の各書き込み後のの各レベルを取得または設定するためのプロパティが用意されて Indent IndentSize AutoFlush います。

のおよびを設定するには AutoFlush IndentSize Trace 、アプリケーションの名前に対応する構成ファイルを編集します。 構成ファイルは、次の例のように書式設定する必要があります。

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

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

注意

Visual Studio プロジェクトでは、デバッグビルドに対して "デバッグ" 条件付きコンパイルシンボルが既定で定義されており、"トレース" シンボルはデバッグビルドとリリースビルドの両方に対して定義されています。 この動作を無効にする方法については、Visual Studio のドキュメントを参照してください。

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

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

プロパティ

AutoFlush

すべての書き込み後に ListenersFlush() を呼び出すかどうかを取得または設定します。

CorrelationManager

このトレースのスレッドの相関マネージャーを取得します。

IndentLevel

インデント レベルを取得または設定します。

IndentSize

1 つのインデントに含まれるスペースの数を取得または設定します。

Listeners

トレース出力を監視しているリスナーのコレクションを取得します。

UseGlobalLock

グローバル ロックを使用するかどうかを示す値を取得または設定します。

メソッド

Assert(Boolean)

条件をチェックします。条件が false の場合、呼び出し履歴を見せるメッセージ ボックスを表示します。

Assert(Boolean, String)

条件をチェックします。条件が false の場合、指定したメッセージを出力し、コール スタックを示すメッセージ ボックスを表示します。

Assert(Boolean, String, String)

条件をチェックします。条件が false の場合、指定した 2 つのメッセージを出力し、コール スタックを示すメッセージ ボックスを表示します。

Close()

出力バッファーをフラッシュし、Listeners を閉じます。

Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
Fail(String)

指定されたエラー メッセージを出力します。

Fail(String, String)

エラー メッセージ、および詳細なエラー メッセージを出力します。

Flush()

出力バッファーをフラッシュします。また、バッファー内のデータが Listeners に書き込まれるようにします。

GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
Indent()

現在の IndentLevel を 1 だけ大きくします。

MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
Refresh()

トレース構成データを更新します。

ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)
TraceError(String)

指定されたメッセージを使用して、エラー メッセージを Listeners コレクションのトレース リスナーに書き込みます。

TraceError(String, Object[])

指定されたオブジェクトの配列および書式設定情報を使用して、Listeners コレクションのトレース リスナーにエラー メッセージを書き込みます。

TraceInformation(String)

指定されたメッセージを使用して、情報メッセージを Listeners コレクションのトレース リスナーに書き込みます。

TraceInformation(String, Object[])

指定されたオブジェクトの配列および書式設定情報を使用して、Listeners コレクションのトレース リスナーに情報メッセージを書き込みます。

TraceWarning(String)

指定されたメッセージを使用して、警告メッセージを Listeners コレクションのトレース リスナーに書き込みます。

TraceWarning(String, Object[])

指定されたオブジェクトの配列および書式設定情報を使用して、Listeners コレクションのトレース リスナーに警告メッセージを書き込みます。

Unindent()

現在の IndentLevel を 1 だけ減らします。

Write(Object)

オブジェクトの ToString() メソッドの値を Listeners コレクションのトレース リスナーに書き込みます。

Write(Object, String)

カテゴリ名とオブジェクトの ToString() メソッドの値を Listeners コレクションのトレース リスナーに書き込みます。

Write(String)

Listeners コレクションのトレース リスナーにメッセージを書き込みます。

Write(String, String)

カテゴリ名とメッセージを Listeners コレクションのトレース リスナーに書き込みます。

WriteIf(Boolean, Object)

条件が true の場合、オブジェクトの ToString() メソッドの値を Listeners コレクションのトレース リスナーに書き込みます。

WriteIf(Boolean, Object, String)

条件が true の場合は、カテゴリ名とオブジェクトの ToString() メソッドの値を Listeners コレクションのトレース リスナーに書き込みます。

WriteIf(Boolean, String)

条件が true である場合、メッセージを Listeners コレクションのトレース リスナーに書き込みます。

WriteIf(Boolean, String, String)

条件が true である場合、カテゴリ名とメッセージを Listeners コレクションのトレース リスナーに書き込みます。

WriteLine(Object)

オブジェクトの ToString() メソッドの値を Listeners コレクションのトレース リスナーに書き込みます。

WriteLine(Object, String)

カテゴリ名とオブジェクトの ToString() メソッドの値を Listeners コレクションのトレース リスナーに書き込みます。

WriteLine(String)

Listeners コレクションのトレース リスナーにメッセージを書き込みます。

WriteLine(String, String)

カテゴリ名とメッセージを Listeners コレクションのトレース リスナーに書き込みます。

WriteLineIf(Boolean, Object)

条件が true の場合、オブジェクトの ToString() メソッドの値を Listeners コレクションのトレース リスナーに書き込みます。

WriteLineIf(Boolean, Object, String)

条件が true の場合は、カテゴリ名とオブジェクトの ToString() メソッドの値を Listeners コレクションのトレース リスナーに書き込みます。

WriteLineIf(Boolean, String)

条件が true である場合、メッセージを Listeners コレクションのトレース リスナーに書き込みます。

WriteLineIf(Boolean, String, String)

条件が true である場合、カテゴリ名とメッセージを Listeners コレクションのトレース リスナーに書き込みます。

適用対象

スレッド セーフ

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

こちらもご覧ください