Trace Trace Trace Trace Class

定義

コードの実行をトレースするための一連のメソッドとプロパティを提供します。Provides a set of methods and properties that help you trace the execution of your code. このクラスは継承できません。This class cannot be inherited.

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

次の例でTraceは、を使用して、プログラムの実行の開始と終了を示します。The following example uses Trace to indicate the beginning and the end of a program's execution. また、この例でTrace.IndentTrace.Unindent 、メソッドとメソッドを使用して、トレース出力を区別しています。The example also uses the Trace.Indent and Trace.Unindent methods to distinguish the tracing output. Trace使用方法の詳細な例については、「方法:トレースステートメントをアプリケーションコードに追加します。For a more complete example of the use of Trace, see How to: Add Trace Statements to Application Code.

// 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クラスのプロパティとメソッドを使用して、リリースビルドをインストルメント化できます。You can use the properties and methods in the Trace class to instrument release builds. インストルメンテーションを使用すると、実際の設定で実行されているアプリケーションの正常性を監視できます。Instrumentation allows you to monitor the health of your application running in real-life settings. トレースは、実行中のシステムに支障をきたすことなく、問題を特定して修正するのに役立ちます。Tracing helps you isolate problems and fix them without disturbing a running system.

このクラスには、 Assertダイアログボックスを表示するメソッドと、常Failにのアサーションを生成するメソッドが用意されています。This class provides methods to display an Assert dialog box, and to emit an assertion that will always Fail. このWriteクラスはWriteLine WriteLineIf、、、、およびの各バリエーションで書き込みメソッドを提供します。 WriteIfThis class provides write methods in the following variations: Write, WriteLine, WriteIf, and WriteLineIf.

クラスBooleanSwitchTraceSwitchクラスは、トレース出力を動的に制御する手段を提供します。The BooleanSwitch and TraceSwitch classes provide means to dynamically control the tracing output. これらのスイッチの値は、アプリケーションを再コンパイルせずに変更できます。You can modify the values of these switches without recompiling your application. 構成ファイルを使用してスイッチを設定するSwitch 方法については、クラスと「方法:トレーススイッチの作成、初期化、および構成に関するトピックを参照してください。For information on using the configuration file to set a switch, see the Switch class and the How to: Create, Initialize and Configure Trace Switches topic.

インスタンスをコレクションに追加TraceListenerしたり、 Listenersコレクションからインスタンスを削除したりすることで、トレース出力のターゲットをカスタマイズできます。You can customize the tracing output's target by adding TraceListener instances to or removing instances from the Listeners collection. コレクションは、 TraceクラスDebugとクラスの両方で共有されます。いずれかのクラスにトレースリスナーを追加すると、リスナーが両方に追加されます。 ListenersThe Listeners collection is shared by both the Debug and the Trace classes; adding a trace listener to either class adds the listener to both. 既定では、トレース出力はDefaultTraceListenerクラスを使用して出力されます。By default, trace output is emitted using the DefaultTraceListener class.

注意

Listeners コレクションにトレース リスナーを追加することで、トレース リスナーによって使用されるリソースが利用できない場合、トレース中に例外を発生させることになります。Adding a trace listener to the Listeners collection can cause an exception to be thrown while tracing, if a resource used by the trace listener is not available. 条件とスローされる例外は、トレース リスナーに依存し、このトピックで列挙することはできません。The conditions and the exception thrown depend on the trace listener and cannot be enumerated in this topic. トレース リスナーから例外を検出し、処理するために、Trace メソッドの呼び出しをtry / catchブロックに配置することができます。It may be useful to place calls to the Trace methods in try/catch blocks to detect and handle any exceptions from trace listeners.

注意

トレースリスナーを部分信頼コードに追加すると、 SecurityException例外が発生します。これは、トレースリスナーを追加するにはアクセス許可が必要UnmanagedCodeであるためです。If you add trace listeners to partially trusted code, you will get a SecurityException exception, because adding trace listeners requires UnmanagedCode permission. Visual Studio のサンドボックスで実行されている部分的に信頼されたコードをトレースするには、トレースリスナーを追加しないでください。To trace partially trusted code that is running in a sandbox in Visual Studio, do not add trace listeners. 代わりに、出力ウィンドウTraceDebugおよびメッセージを表示します。Instead, view the Trace and Debug messages in the Output window.

クラスTraceには、、、の各書き込みAutoFlush後のIndentの各IndentSizeレベルを取得または設定するためのプロパティが用意されています。The Trace class provides properties to get or set the level of Indent, the IndentSize, and whether to AutoFlush after each write.

AutoFlush IndentSizeおよびを設定するには、アプリケーションの名前に対応する構成ファイルを編集します。TraceTo set the AutoFlush and IndentSize for Trace, you can edit the configuration file that corresponds to the name of your application. 構成ファイルは、次の例のように書式設定する必要があります。The configuration file should be formatted like the following example:

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

属性ConditionalAttributeは、のTraceメソッドに適用されます。The ConditionalAttribute attribute is applied to the methods of Trace. をサポートConditionalAttributeするコンパイラは、"TRACE" が条件付きコンパイルシンボルとして定義されていない限り、これらのメソッドの呼び出しを無視します。Compilers that support ConditionalAttribute ignore calls to these methods unless "TRACE" is defined as a conditional compilation symbol. がサポートされているかどうかConditionalAttribute 、および条件付きコンパイルシンボルを定義するための構文を確認するには、コンパイラのドキュメントを参照してください。Refer to a compiler's documentation to determine whether ConditionalAttribute is supported and the syntax for defining a conditional compilation symbol.

注意

Visual Studio プロジェクトでは、デバッグビルドに対して "デバッグ" 条件付きコンパイルシンボルが既定で定義されており、"トレース" シンボルはデバッグビルドとリリースビルドの両方に対して定義されています。In Visual Studio projects, by default, the "DEBUG" conditional compilation symbol is defined for debug builds, and the "TRACE" symbol is defined for both debug and release builds. この動作を無効にする方法については、Visual Studio のドキュメントを参照してください。For information about how to disable this behavior, see the Visual Studio documentation.

でC#"トレース" 条件付きコンパイルシンボルを定義するには/d:TRACE 、コマンドラインを使用してコードをコンパイルするときにコンパイラのコマンドラインに#define TRACEオプションを追加するか、ファイルの先頭にを追加します。To define the "TRACE" conditional compilation symbol in C#, add the /d:TRACE option to the compiler command line when you compile your code using a command line, or add #define TRACE to the top of your file. Visual Basic で、コンパイラの/d:TRACE=Trueコマンドラインにオプションを追加するか#Const TRACE=True 、ファイルにを追加します。In Visual Basic, add the /d:TRACE=True option to the compiler command line or add #Const TRACE=True to the file.

ConditionalAttributeは、 C++コンパイラではサポートされていません。ConditionalAttribute is not supported by the C++ compiler. 同等の機能を提供Traceするには、 #if defined(TRACE) ... #endif /DTRACEブロック内でのメソッドの呼び出しを囲み、コンパイラのコマンドラインにオプションを追加する#define TRACEか、ファイルにを追加する必要があります。To provide equivalent functionality, you must enclose calls to the methods of Trace in an #if defined(TRACE) ... #endif block, and add the /DTRACE option to the compiler command line or add #define TRACE to the file.

プロパティ

AutoFlush AutoFlush AutoFlush AutoFlush

すべての書き込み後に ListenersFlush() を呼び出すかどうかを取得または設定します。Gets or sets whether Flush() should be called on the Listeners after every write.

CorrelationManager CorrelationManager CorrelationManager CorrelationManager

このトレースのスレッドの相関マネージャーを取得します。Gets the correlation manager for the thread for this trace.

IndentLevel IndentLevel IndentLevel IndentLevel

インデント レベルを取得または設定します。Gets or sets the indent level.

IndentSize IndentSize IndentSize IndentSize

1 つのインデントに含まれるスペースの数を取得または設定します。Gets or sets the number of spaces in an indent.

Listeners Listeners Listeners Listeners

トレース出力を監視しているリスナーのコレクションを取得します。Gets the collection of listeners that is monitoring the trace output.

UseGlobalLock UseGlobalLock UseGlobalLock UseGlobalLock

グローバル ロックを使用するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the global lock should be used.

メソッド

Assert(Boolean) Assert(Boolean) Assert(Boolean) Assert(Boolean)

条件をチェックします。条件が false の場合、呼び出し履歴を見せるメッセージ ボックスを表示します。Checks for a condition; if the condition is false, displays a message box that shows the call stack.

Assert(Boolean, String) Assert(Boolean, String) Assert(Boolean, String) Assert(Boolean, String)

条件をチェックします。条件が false の場合、指定したメッセージを出力し、コール スタックを示すメッセージ ボックスを表示します。Checks for a condition; if the condition is false, outputs a specified message and displays a message box that shows the call stack.

Assert(Boolean, String, String) Assert(Boolean, String, String) Assert(Boolean, String, String) Assert(Boolean, String, String)

条件をチェックします。条件が false の場合、指定した 2 つのメッセージを出力し、コール スタックを示すメッセージ ボックスを表示します。Checks for a condition; if the condition is false, outputs two specified messages and displays a message box that shows the call stack.

Close() Close() Close() Close()

出力バッファーをフラッシュし、Listeners を閉じます。Flushes the output buffer, and then closes the Listeners.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
Fail(String) Fail(String) Fail(String) Fail(String)

指定されたエラー メッセージを出力します。Emits the specified error message.

Fail(String, String) Fail(String, String) Fail(String, String) Fail(String, String)

エラー メッセージ、および詳細なエラー メッセージを出力します。Emits an error message, and a detailed error message.

Flush() Flush() Flush() Flush()

出力バッファーをフラッシュします。また、バッファー内のデータが Listeners に書き込まれるようにします。Flushes the output buffer, and causes buffered data to be written to the Listeners.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
Indent() Indent() Indent() Indent()

現在の IndentLevel を 1 だけ大きくします。Increases the current IndentLevel by one.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
Refresh() Refresh() Refresh() Refresh()

トレース構成データを更新します。Refreshes the trace configuration data.

ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)
TraceError(String) TraceError(String) TraceError(String) TraceError(String)

指定されたメッセージを使用して、エラー メッセージを Listeners コレクションのトレース リスナーに書き込みます。Writes an error message to the trace listeners in the Listeners collection using the specified message.

TraceError(String, Object[]) TraceError(String, Object[]) TraceError(String, Object[]) TraceError(String, Object[])

指定されたオブジェクトの配列および書式設定情報を使用して、Listeners コレクションのトレース リスナーにエラー メッセージを書き込みます。Writes an error message to the trace listeners in the Listeners collection using the specified array of objects and formatting information.

TraceInformation(String) TraceInformation(String) TraceInformation(String) TraceInformation(String)

指定されたメッセージを使用して、情報メッセージを Listeners コレクションのトレース リスナーに書き込みます。Writes an informational message to the trace listeners in the Listeners collection using the specified message.

TraceInformation(String, Object[]) TraceInformation(String, Object[]) TraceInformation(String, Object[]) TraceInformation(String, Object[])

指定されたオブジェクトの配列および書式設定情報を使用して、Listeners コレクションのトレース リスナーに情報メッセージを書き込みます。Writes an informational message to the trace listeners in the Listeners collection using the specified array of objects and formatting information.

TraceWarning(String) TraceWarning(String) TraceWarning(String) TraceWarning(String)

指定されたメッセージを使用して、警告メッセージを Listeners コレクションのトレース リスナーに書き込みます。Writes a warning message to the trace listeners in the Listeners collection using the specified message.

TraceWarning(String, Object[]) TraceWarning(String, Object[]) TraceWarning(String, Object[]) TraceWarning(String, Object[])

指定されたオブジェクトの配列および書式設定情報を使用して、Listeners コレクションのトレース リスナーに警告メッセージを書き込みます。Writes a warning message to the trace listeners in the Listeners collection using the specified array of objects and formatting information.

Unindent() Unindent() Unindent() Unindent()

現在の IndentLevel を 1 だけ減らします。Decreases the current IndentLevel by one.

Write(Object) Write(Object) Write(Object) Write(Object)

オブジェクトの ToString() メソッドの値を Listeners コレクションのトレース リスナーに書き込みます。Writes the value of the object's ToString() method to the trace listeners in the Listeners collection.

Write(Object, String) Write(Object, String) Write(Object, String) Write(Object, String)

カテゴリ名とオブジェクトの ToString() メソッドの値を Listeners コレクションのトレース リスナーに書き込みます。Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection.

Write(String) Write(String) Write(String) Write(String)

Listeners コレクションのトレース リスナーにメッセージを書き込みます。Writes a message to the trace listeners in the Listeners collection.

Write(String, String) Write(String, String) Write(String, String) Write(String, String)

カテゴリ名とメッセージを Listeners コレクションのトレース リスナーに書き込みます。Writes a category name and a message to the trace listeners in the Listeners collection.

WriteIf(Boolean, Object) WriteIf(Boolean, Object) WriteIf(Boolean, Object) WriteIf(Boolean, Object)

条件が true の場合、オブジェクトの ToString() メソッドの値を Listeners コレクションのトレース リスナーに書き込みます。Writes the value of the object's ToString() method to the trace listeners in the Listeners collection if a condition is true.

WriteIf(Boolean, Object, String) WriteIf(Boolean, Object, String) WriteIf(Boolean, Object, String) WriteIf(Boolean, Object, String)

条件が true の場合は、カテゴリ名とオブジェクトの ToString() メソッドの値を Listeners コレクションのトレース リスナーに書き込みます。Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection if a condition is true.

WriteIf(Boolean, String) WriteIf(Boolean, String) WriteIf(Boolean, String) WriteIf(Boolean, String)

条件が true である場合、メッセージを Listeners コレクションのトレース リスナーに書き込みます。Writes a message to the trace listeners in the Listeners collection if a condition is true.

WriteIf(Boolean, String, String) WriteIf(Boolean, String, String) WriteIf(Boolean, String, String) WriteIf(Boolean, String, String)

条件が true である場合、カテゴリ名とメッセージを Listeners コレクションのトレース リスナーに書き込みます。Writes a category name and message to the trace listeners in the Listeners collection if a condition is true.

WriteLine(Object) WriteLine(Object) WriteLine(Object) WriteLine(Object)

オブジェクトの ToString() メソッドの値を Listeners コレクションのトレース リスナーに書き込みます。Writes the value of the object's ToString() method to the trace listeners in the Listeners collection.

WriteLine(Object, String) WriteLine(Object, String) WriteLine(Object, String) WriteLine(Object, String)

カテゴリ名とオブジェクトの ToString() メソッドの値を Listeners コレクションのトレース リスナーに書き込みます。Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection.

WriteLine(String) WriteLine(String) WriteLine(String) WriteLine(String)

Listeners コレクションのトレース リスナーにメッセージを書き込みます。Writes a message to the trace listeners in the Listeners collection.

WriteLine(String, String) WriteLine(String, String) WriteLine(String, String) WriteLine(String, String)

カテゴリ名とメッセージを Listeners コレクションのトレース リスナーに書き込みます。Writes a category name and message to the trace listeners in the Listeners collection.

WriteLineIf(Boolean, Object) WriteLineIf(Boolean, Object) WriteLineIf(Boolean, Object) WriteLineIf(Boolean, Object)

条件が true の場合、オブジェクトの ToString() メソッドの値を Listeners コレクションのトレース リスナーに書き込みます。Writes the value of the object's ToString() method to the trace listeners in the Listeners collection if a condition is true.

WriteLineIf(Boolean, Object, String) WriteLineIf(Boolean, Object, String) WriteLineIf(Boolean, Object, String) WriteLineIf(Boolean, Object, String)

条件が true の場合は、カテゴリ名とオブジェクトの ToString() メソッドの値を Listeners コレクションのトレース リスナーに書き込みます。Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection if a condition is true.

WriteLineIf(Boolean, String) WriteLineIf(Boolean, String) WriteLineIf(Boolean, String) WriteLineIf(Boolean, String)

条件が true である場合、メッセージを Listeners コレクションのトレース リスナーに書き込みます。Writes a message to the trace listeners in the Listeners collection if a condition is true.

WriteLineIf(Boolean, String, String) WriteLineIf(Boolean, String, String) WriteLineIf(Boolean, String, String) WriteLineIf(Boolean, String, String)

条件が true である場合、カテゴリ名とメッセージを Listeners コレクションのトレース リスナーに書き込みます。Writes a category name and message to the trace listeners in the Listeners collection if a condition is true.

セキュリティ

SecurityPermission
アンマネージコードを操作するために使用します。for operating with unmanaged code. セキュリティアクション: DemandSecurity action: Demand. 関連付けられた列挙型:UnmanagedCodeAssociated enumeration: UnmanagedCode

適用対象

スレッド セーフ

この型はスレッド セーフです。This type is thread safe.

こちらもご覧ください