trace

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

Trace クラス

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

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

Visual Basic (宣言)

Public NotInheritable Class
 Trace

Visual Basic (使用法)

Dim instance As Trace

C#

public sealed class Trace

C++

public ref class Trace sealed

J#

public final class Trace

JScript

public final class Trace

解説

Trace クラスのプロパティやメソッドを使用して、リリース ビルドをインストルメントできます。インストルメンテーションにより、実際の設定で実行されるアプリケーションの状態を監視できます。トレースを行うと、実行中のシステムを中断せずに問題を特定し、修復できます。

メモ
C# でトレースを有効にするには、コードのコンパイル時に /d:TRACE フラグをコンパイラのコマンド ラインに追加するか、#define TRACE をファイルの最上部に挿入します。Visual Basic では、コンパイラのコマンド ラインに /d:TRACE=True フラグを追加します。C++ でこれと同等の機能を使用するには、このクラスのメソッド呼び出しを #ifdef TRACE... #endif ブロックで囲む必要があります。この構文はコンパイラ固有です。Trace クラスのメソッドには条件付きコンパイル属性があるため、上記以外のコンパイラを使用する場合は、使用するコンパイラのドキュメントを参照して条件付きコンパイルを有効にする必要があります。

Visual Studio 2005 プロジェクトでは、Trace は既定で有効になっています。したがって、リリース ビルドとデバッグ ビルドの両方ですべての Trace メソッドのコードが生成されます。これにより、エンド ユーザーはプログラムを再コンパイルせずに問題を特定できるトレースを有効にできます。対照的に、既定では、Debug がリリース ビルドでは無効になるため、Debug メソッドの実行可能コードは生成されません。Trace を無効にする方法の詳細については、Visual Studio 2005 のドキュメントを参照してください。

このクラスは Assert ダイアログ ボックスを表示するメソッドを提供し、常に Fail になるアサーションを出力するメソッドを提供します。このクラスは次の種類の書き込みメソッドを提供します。Write、WriteLine、WriteIf、および WriteLineIf。

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

Listeners コレクションに TraceListener インスタンスを追加したり、コレクションからインスタンスを削除することによって、トレース出力対象をカスタマイズできます。既定では、トレース出力は DefaultTraceListener クラスを使用すると出力されます。

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

Trace に AutoFlush や IndentSize を設定するために、アプリケーション名に対応する構成ファイルを編集することもできます。構成ファイルの書式は次の例のようになります。

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

Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows CE プラットフォームメモ : .NET Compact Framework は、構成ファイルを使用するトレース機能をサポートしていません。

Topic	Location
チュートリアル : ASP.NET トレースと System.Diagnostics トレースの統合	ASP .NET Web アプリケーションの作成
方法 : アプリケーション コードにトレース ステートメントを追加する	.NET Framework: デバッグ
方法 : アプリケーションのコードをトレースする	.NET Framework: デバッグ
方法 : トレース スイッチを設定する	.NET Framework: デバッグ
方法 : トレース リスナを作成し初期化する	.NET Framework: デバッグ
方法 : トレースとデバッグを指定して条件付きコンパイルを実行する	.NET Framework: デバッグ

使用例

Trace を使用してプログラム実行の最初と最後を指定する例を次に示します。この例では、Indent と Unindent も使用してトレース出力を区別します。

Visual Basic

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 'Main

C#

static int Main(string[]
 args)
{
   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();
   return 0;
}

C++

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

.NET Framework のセキュリティ

• SecurityPermission  (アンマネージ コードを操作するために必要なアクセス許可)要求値 Demand ; (関連する列挙体) SecurityPermissionFlag.UnmanagedCode

継承階層

System.Object
  System.Diagnostics.Trace

スレッド セーフ

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Trace メンバ
System.Diagnostics 名前空間
Debug クラス
Switch クラス
BooleanSwitch クラス
TraceSwitch
TraceListener
DefaultTraceListener クラス
EventLogTraceListener クラス
TraceListenerCollection
ConditionalAttribute クラス

Trace プロパティ

パブリック プロパティ

	名前	説明
	AutoFlush	各書き込みの後で Listeners で Flush を呼び出すかどうかを示す値を取得または設定します。
	CorrelationManager	このトレースのスレッド用の相関マネージャを取得します。
	IndentLevel	インデントのレベルを取得または設定します。
	IndentSize	1 つのインデントに含まれる空白の数を取得または設定します。
	Listeners	トレース出力を監視するリスナのコレクションを取得します。
	UseGlobalLock	グローバル ロックを使用するかどうかを示す値を取得または設定します。

参照

関連項目

Trace クラス
System.Diagnostics 名前空間
Debug クラス
Switch クラス
BooleanSwitch クラス
TraceSwitch
TraceListener
DefaultTraceListener クラス
EventLogTraceListener クラス
TraceListenerCollection
ConditionalAttribute クラス

Trace メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Assert	オーバーロードされます。 条件をチェックし、その条件が false の場合は、メッセージを表示します。
	Close	出力バッファをフラッシュしてから Listeners を終了します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	Fail	オーバーロードされます。 エラー メッセージを出力します。
	Flush	出力バッファをフラッシュし、バッファ内のデータを Listeners に書き込みます。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	Indent	現在の IndentLevel を 1 だけ増やします。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Refresh	トレース構成データを更新します。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)
	TraceError	オーバーロードされます。 エラー情報を Listeners コレクションのトレース リスナに書き込みます。
	TraceInformation	オーバーロードされます。 情報メッセージを Listeners コレクションのトレース リスナに書き込みます。
	TraceWarning	オーバーロードされます。 警告情報を Listeners コレクションのトレース リスナに書き込みます。
	Unindent	現在の IndentLevel を 1 だけ減らします。
	Write	オーバーロードされます。 トレースについての情報を Listeners コレクションのトレース リスナに書き込みます。
	WriteIf	オーバーロードされます。 条件が true の場合、トレースについての情報を Listeners コレクションのトレース リスナに書き込みます。
	WriteLine	オーバーロードされます。 トレースについての情報を Listeners コレクションのトレース リスナに書き込みます。
	WriteLineIf	オーバーロードされます。 条件が true の場合、トレースについての情報を Listeners コレクションのトレース リスナに書き込みます。

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

Trace クラス
System.Diagnostics 名前空間
Debug クラス
Switch クラス
BooleanSwitch クラス
TraceSwitch
TraceListener
DefaultTraceListener クラス
EventLogTraceListener クラス
TraceListenerCollection
ConditionalAttribute クラス

Trace メンバ

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

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

パブリック プロパティ

	名前	説明
	AutoFlush	各書き込みの後で Listeners で Flush を呼び出すかどうかを示す値を取得または設定します。
	CorrelationManager	このトレースのスレッド用の相関マネージャを取得します。
	IndentLevel	インデントのレベルを取得または設定します。
	IndentSize	1 つのインデントに含まれる空白の数を取得または設定します。
	Listeners	トレース出力を監視するリスナのコレクションを取得します。
	UseGlobalLock	グローバル ロックを使用するかどうかを示す値を取得または設定します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Assert	オーバーロードされます。 条件をチェックし、その条件が false の場合は、メッセージを表示します。
	Close	出力バッファをフラッシュしてから Listeners を終了します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	Fail	オーバーロードされます。 エラー メッセージを出力します。
	Flush	出力バッファをフラッシュし、バッファ内のデータを Listeners に書き込みます。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	Indent	現在の IndentLevel を 1 だけ増やします。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Refresh	トレース構成データを更新します。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)
	TraceError	オーバーロードされます。 エラー情報を Listeners コレクションのトレース リスナに書き込みます。
	TraceInformation	オーバーロードされます。 情報メッセージを Listeners コレクションのトレース リスナに書き込みます。
	TraceWarning	オーバーロードされます。 警告情報を Listeners コレクションのトレース リスナに書き込みます。
	Unindent	現在の IndentLevel を 1 だけ減らします。
	Write	オーバーロードされます。 トレースについての情報を Listeners コレクションのトレース リスナに書き込みます。
	WriteIf	オーバーロードされます。 条件が true の場合、トレースについての情報を Listeners コレクションのトレース リスナに書き込みます。
	WriteLine	オーバーロードされます。 トレースについての情報を Listeners コレクションのトレース リスナに書き込みます。
	WriteLineIf	オーバーロードされます。 条件が true の場合、トレースについての情報を Listeners コレクションのトレース リスナに書き込みます。

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

Trace クラス
System.Diagnostics 名前空間
Debug クラス
Switch クラス
BooleanSwitch クラス
TraceSwitch
TraceListener
DefaultTraceListener クラス
EventLogTraceListener クラス
TraceListenerCollection
ConditionalAttribute クラス