XmlWriterTraceListener.TraceTransfer(TraceEventCache, String, Int32, String, Guid) メソッド

定義

関連するアクティビティの ID を含むトレース情報、メッセージ、およびイベント情報をファイルまたはストリームに書き込みます。Writes trace information including the identity of a related activity, a message, and event information to the file or stream.

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

パラメーター

eventCache
TraceEventCache

現在のプロセス ID、スレッド ID、およびスタック トレース情報を格納している TraceEventCacheA TraceEventCache that contains the current process ID, thread ID, and stack trace information.

source
String

ソース名。The source name.

id
Int32

イベントの数値識別子。A numeric identifier for the event.

message
String

書き込むトレース メッセージ。A trace message to write.

relatedActivityId
Guid

関連するアクティビティを識別する Guid 構造体。A Guid structure that identifies a related activity.

注釈

TraceTransfer メソッドは、関連するトレースの関連付けに使用されます。The TraceTransfer method is used for the correlation of related traces. トレースのヘッダーとフッターには、eventCachesourceid、および relatedActivityId パラメーターが使用されます。The eventCache, source, id, and relatedActivityId parameters are used in the header and footer of the trace. id パラメーターは書き込み前に符号なし整数に変換されるため、負の id 値は大きな正の整数として書き込まれます。The id parameter is converted to an unsigned integer before writing, so a negative id value is written as a large positive integer. message パラメーターは、Message 要素として書き込まれます。The message parameter is written as the Message element. Guid.ToString(String) メソッドは、ヘッダーに表示される "B" 形式の文字列に relatedActivityId値を変換するために呼び出されます。The Guid.ToString(String) method is called to convert the relatedActivityIdvalue to a "B" formatted string, which appears in the header. フッターの SubTypeName 要素は、トレースイベントの種類を Transferとして識別します。The SubTypeName element in the footer identifies the trace event type as a Transfer.

重要

TraceTransfer メソッドは、アプリケーションコードから呼び出すためのものではありません。The TraceTransfer method is not intended to be called by application code. これは、TraceTransfer メソッドのトレース情報を出力するために、TraceSource オブジェクトによって呼び出されることを意図しています。It is intended to be called by a TraceSource object to emit the trace information for its TraceTransfer method.

適用対象