FileLogTraceListener.TraceEvent メソッド

定義

トレース情報とイベント情報を出力ファイルまたはストリームに書き込みます。

オーバーロード

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

トレース情報、メッセージ、およびイベント情報を出力ファイルまたはストリームに書き込みます。

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

トレース情報、書式設定されたオブジェクトの配列、およびイベント情報を出力ファイルまたはストリームに書き込みます。

注釈

TraceEvent メソッドは、アプリケーション コードによって呼び出されるものではありません。 これらのメソッドは、トレース データを出力に Debug書き込むには、、 TraceTraceSource クラスのメンバーによって呼び出されます。

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

トレース情報、メッセージ、およびイベント情報を出力ファイルまたはストリームに書き込みます。

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, System::String ^ message);
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, string message);
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string -> unit
Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, message As String)

パラメーター

eventCache
TraceEventCache

現在のプロセス ID、スレッド ID、およびスタック トレース情報を格納している TraceEventCache オブジェクト。

source
String

このメソッドを呼び出したトレース ソースの名前。

eventType
TraceEventType

TraceEventType 列挙値のいずれか。

id
Int32

イベントの数値識別子。

message
String

書き込むメッセージ。

注釈

このメソッドは以下の操作を行います。

  1. 出力用のデータとコンテキスト情報の書式を設定します。

  2. 必要に応じて、新しいログ ファイルを作成します。

  3. ログ ファイルに情報を書き込みます。

新しいログ ファイルの作成の詳細については、「」を参照してください FullLogFileName

次の表に、出力フィールドを表示する順序で示します。 フィールドは、 プロパティが指定する文字列 Delimiter で区切られ、その後に行ターミネータが続きます。

フィールド 出力条件 説明
source 常に。 name の値。
severity 常に。 の列挙値名 eventType
id 常に。 id の文字列形式。
message 常に。 message の値。
callStack プロパティで Callstack フラグが設定されている TraceOutputOptions 場合。 CallstackeventCacheプロパティ。
CorrelationID プロパティで LogicalOperationStack フラグが設定されている TraceOutputOptions 場合。 ThreadIdeventCacheプロパティ。
DateTime プロパティで DateTime フラグが設定されている TraceOutputOptions 場合。 の プロパティeventCacheDateTime文字列表現。 インバリアント カルチャは、文字列変換に使用されます。
ProcessID プロパティで ProcessId フラグが設定されている TraceOutputOptions 場合。 の プロパティeventCacheProcessId文字列表現。 インバリアント カルチャは、文字列変換に使用されます。
ThreadID プロパティで ThreadId フラグが設定されている TraceOutputOptions 場合。 ThreadIdeventCacheプロパティ。
Timestamp プロパティで Timestamp フラグが設定されている TraceOutputOptions 場合。 の プロパティeventCacheTimestamp文字列表現。 インバリアント カルチャは、文字列変換に使用されます。
HostName プロパティが IncludeHostName の場合。True コンピューターの名前です。

こちらもご覧ください

適用対象

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

トレース情報、書式設定されたオブジェクトの配列、およびイベント情報を出力ファイルまたはストリームに書き込みます。

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, string format, params object[] args);
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string * obj[] -> unit
Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, format As String, ParamArray args As Object())

パラメーター

eventCache
TraceEventCache

現在のプロセス ID、スレッド ID、およびスタック トレース情報を格納している TraceEventCache オブジェクト。

source
String

このメソッドを呼び出したトレース ソースの名前。

eventType
TraceEventType

TraceEventType 列挙値のいずれか。

id
Int32

イベントの数値識別子。

format
String

0 個以上の書式項目を格納している書式指定文字列。args 配列内のオブジェクトに対応します。

args
Object[]

0 個以上の書式設定対象オブジェクトを含んだ Object 配列。

注釈

このメソッドは以下の操作を行います。

  1. 出力用のデータとコンテキスト情報の書式を設定します。

  2. 必要に応じて、新しいログ ファイルを作成します。

  3. ログ ファイルに情報を書き込みます。

新しいログ ファイルの作成の詳細については、「」を参照してください FullLogFileName

次の表に、出力フィールドを表示する順序で示します。 フィールドは、 プロパティが指定する文字列 Delimiter で区切られ、その後に行ターミネータが続きます。

フィールド 出力条件 説明
source Always (常に) name の値。
severity Always (常に) の列挙値名 eventType
id Always (常に) id の文字列形式。
message Always (常に) のデータ args は、文字列で format 書式設定され、文字列変換にインバリアント カルチャを使用します。
callStack プロパティで Callstack フラグが設定されている TraceOutputOptions 場合。 CallstackeventCacheプロパティ。
CorrelationID プロパティで LogicalOperationStack フラグが設定されている TraceOutputOptions 場合。 ThreadIdeventCacheプロパティ。
DateTime プロパティで DateTime フラグが設定されている TraceOutputOptions 場合。 の プロパティeventCacheDateTime文字列表現。 インバリアント カルチャは、文字列変換に使用されます。
ProcessID プロパティで ProcessId フラグが設定されている TraceOutputOptions 場合。 の プロパティeventCacheProcessId文字列表現。 インバリアント カルチャは、文字列変換に使用されます。
ThreadID プロパティで ThreadId フラグが設定されている TraceOutputOptions 場合。 ThreadIdeventCacheプロパティ。
Timestamp プロパティで Timestamp フラグが設定されている TraceOutputOptions 場合。 の プロパティeventCacheTimestamp文字列表現。 インバリアント カルチャは、文字列変換に使用されます。
HostName プロパティが IncludeHostName の場合。True コンピューターの名前です。

こちらもご覧ください

適用対象