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. 、、、およびrelatedActivityIdの各パラメーターは、トレースのヘッダーとフッターで使用されます。 id source eventCacheThe eventCache, source, id, and relatedActivityId parameters are used in the header and footer of the trace. パラメーターは書き込み前に符号なし整数に変換されるため、 id負の値は大きな正の整数として書き込まれます。 idThe id parameter is converted to an unsigned integer before writing, so a negative id value is written as a large positive integer. パラメーターはMessage要素として書き込まれます。 messageThe message parameter is written as the Message element. このメソッドは、ヘッダーに表示relatedActivityIdされる "B" 書式設定された文字列に値を変換するために呼び出されます。 Guid.ToString(String)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.

セキュリティ

SecurityPermission
アンマネージコードを呼び出すことができる。for the ability to call unmanaged code. UnmanagedCode (関連する列挙体)Associated enumeration: UnmanagedCode.

適用対象