TraceOptions 列挙体

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

TraceOptions 列挙体

メモ : この列挙体は、.NET Framework version 2.0 で新しく追加されたものです。

トレース出力に書き込むトレース データ オプションを指定します。

この列挙体には、メンバ値のビットごとの組み合わせを可能にする FlagsAttribute 属性が含まれています。

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

Visual Basic (宣言)

<FlagsAttribute> _
Public Enumeration TraceOptions

Visual Basic (使用法)

Dim instance As TraceOptions

C#

[FlagsAttribute] 
public enum TraceOptions

C++

[FlagsAttribute] 
public enum class TraceOptions

J#

/** @attribute FlagsAttribute() */ 
public enum TraceOptions

JScript

FlagsAttribute 
public enum TraceOptions

メンバ

	メンバ名	説明
	Callstack	Environment.StackTrace プロパティの戻り値によって表される呼び出し履歴を書き込みます。
	DateTime	日付と時刻を書き込みます。
	LogicalOperationStack	CorrelationManager.LogicalOperationStack プロパティの戻り値によって表される論理演算履歴を書き込みます。
	None	要素を書き込みません。
	ProcessId	Process.Id プロパティの戻り値によって表されるプロセス ID を書き込みます。
	ThreadId	現在のスレッドの Thread.ManagedThreadId プロパティの戻り値によって表されるスレッド ID を書き込みます。
	Timestamp	System.Diagnostics.Stopwatch.GetTimeStamp メソッドの戻り値によって表されるタイムスタンプを書き込みます。

解説

この列挙体は、トレース リスナがトレース出力に含めるオプションまたは要素を決定する場合に使用されます。トレース リスナは、トレース オプションを TraceOutputOptions プロパティに格納します。

traceOutputOptions 属性を使用して、構成ファイルによって有効化した ConsoleTraceListener のトレース出力オプションを指定するコード例を次に示します。

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="4">
      <listeners>
        <add name="consoleListener"
          type="System.Diagnostics.ConsoleTraceListener" 
          traceOutputOptions="ProcessId, DateTime" />
      </listeners>
    </trace>
  </system.diagnostics>
</configuration>

アプリケーション構成ファイルでのトレース リスナ追加の詳細については、「<trace> の <listeners> 要素」を参照してください。

使用例

TraceOptions 列挙体を使用して、コンソール トレース リスナの TraceOutputOptions プロパティをプログラムで設定するコード例を次に示します。コンソール トレース リスナは、トレース ソースの Listeners プロパティに列挙されるリスナの 1 つです。このコード例は、TraceSource クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

ts.Listeners("console").TraceOutputOptions = ts.Listeners("console").TraceOutputOptions
 Or TraceOptions.Callstack

C#

ts.Listeners["console"].TraceOutputOptions |= TraceOptions.Callstack;

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
System.Diagnostics 名前空間