XmlWriterTraceListener.TraceTransfer メソッド

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

XmlWriterTraceListener.TraceTransfer メソッド

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

関連するアクティビティの ID を含むトレース情報、メッセージ、およびイベント情報をファイルまたはストリームに書き込みます。

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

Visual Basic (宣言)

Public Overrides Sub TraceTransfer
 ( _
    eventCache As TraceEventCache, _
    source As String, _
    id As Integer, _
    message As String, _
    relatedActivityId As Guid _
)

Visual Basic (使用法)

Dim instance As XmlWriterTraceListener
Dim eventCache As TraceEventCache
Dim source As String
Dim id As Integer
Dim message As String
Dim relatedActivityId As Guid

instance.TraceTransfer(eventCache, source, id, message, relatedActivityId)

C#

public override void TraceTransfer (
    TraceEventCache eventCache,
    string source,
    int id,
    string message,
    Guid relatedActivityId
)

C++

public:
virtual void TraceTransfer (
    TraceEventCache^ eventCache, 
    String^ source, 
    int id, 
    String^ message, 
    Guid relatedActivityId
) override

J#

public void TraceTransfer (
    TraceEventCache eventCache, 
    String source, 
    int id, 
    String message, 
    Guid relatedActivityId
)

JScript

public override function TraceTransfer (
    eventCache : TraceEventCache, 
    source : String, 
    id : int, 
    message : String, 
    relatedActivityId : Guid
)

パラメータ

eventCache

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

source

ソース名。

id

イベントの数値識別子。

message

書き込むトレース メッセージ。

relatedActivityId

関連するアクティビティを識別する Guid 構造体。

解説

TraceTransfer メソッドは、関連トレースの相関のために使用されます。eventCache、source、id、および relatedActivityId の各パラメータは、トレースのヘッダーおよびフッターで使用されます。id パラメータは書き込む前に符号なし整数に変換されるため、負の id 値は大きな正の整数として書き込まれます。message パラメータは、Message 要素として書き込まれます。Guid.ToString メソッドが呼び出され、relatedActivityId 値がヘッダーに表示される書式 "B" の文字列に変換されます。フッター内の SubTypeName 要素は、トレース イベントの種類を Transfer として識別します。

重要 :
TraceTransfer メソッドは、アプリケーション コードから呼び出すためのものではありません。TraceSource オブジェクトによって呼び出され、TraceTransfer メソッドのトレース情報を出力します。

.NET Framework のセキュリティ

• SecurityPermission  (アンマネージ コードを呼び出すために必要なアクセス許可)。UnmanagedCode (関連する列挙体)

プラットフォーム

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

参照

関連項目
XmlWriterTraceListener クラス
XmlWriterTraceListener メンバ
System.Diagnostics 名前空間