次の方法で共有


EventProvider.WriteTransferEvent メソッド

定義

イベントをエンド ツー エンドのシナリオで追跡している場合に、一連のイベントをリンクさせます。

オーバーロード

WriteTransferEvent(EventDescriptor, Guid, Object[])

イベントをエンド ツー エンドのシナリオで追跡している場合に、一連のイベントをリンクさせます。 イベント データは、オブジェクトの配列として指定します。

WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)

イベントをエンド ツー エンドのシナリオで追跡している場合に、一連のイベントをリンクさせます。 イベント データは、メモリのブロックとして指定します。

WriteTransferEvent(EventDescriptor, Guid, Object[])

イベントをエンド ツー エンドのシナリオで追跡している場合に、一連のイベントをリンクさせます。 イベント データは、オブジェクトの配列として指定します。

public:
 bool WriteTransferEvent(System::Diagnostics::Eventing::EventDescriptor % eventDescriptor, Guid relatedActivityId, ... cli::array <System::Object ^> ^ eventPayload);
[System.Security.SecurityCritical]
public bool WriteTransferEvent (ref System.Diagnostics.Eventing.EventDescriptor eventDescriptor, Guid relatedActivityId, params object[] eventPayload);
[<System.Security.SecurityCritical>]
member this.WriteTransferEvent : EventDescriptor * Guid * obj[] -> bool
Public Function WriteTransferEvent (ByRef eventDescriptor As EventDescriptor, relatedActivityId As Guid, ParamArray eventPayload As Object()) As Boolean

パラメーター

eventDescriptor
EventDescriptor

書き込むイベントを識別する EventDescriptor のインスタンス。

relatedActivityId
Guid

直前のコンポーネントからの動作識別子。 このパラメーターを使用して、特定のコンポーネントのイベントを直前のコンポーネントのイベントにリンクさせます。

eventPayload
Object[]

書き込むイベント データを格納するオブジェクトの配列。 データは、マニフェストに指定された順序で格納されている必要があります。 配列は 32 オブジェクトまでに制限され、そのうちの 8 つを文字列にすることができます。 イベントの最大データ サイズは、64 KB からイベント ヘッダーのサイズを差し引いた値になります。 セッションのバッファー サイズが小さい場合や、イベントを含んだ拡張データ項目がセッションに存在する場合、イベント サイズはこれよりも小さくなります。

戻り値

イベントが書き込まれた場合は true。それ以外の場合は false。 false の場合は、GetLastWriteEventError() メソッドを呼び出すことで、失敗の原因を調べることができます。

属性

例外

eventPayload に指定されたオブジェクトまたは文字列が多すぎます。

注釈

メソッドは、スレッド コンテキストで設定されたアクティビティ ID を使用して、このコンポーネントを識別します。 アクティビティ ID を設定するには、 メソッドを呼び出します SetActivityId

クラスを使用する Trace 場合は、 メソッドを SetActivityId 使用してアクティビティ ID を指定しないでください。 代わりに、 プロパティに CorrelationManager アクセスして オブジェクトを CorrelationManager 取得します。 次に、 プロパティを ActivityId アクティビティ ID に設定します。 また、 を relatedActivityId 値に ActivityId 設定する必要があります。

適用対象

WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)

イベントをエンド ツー エンドのシナリオで追跡している場合に、一連のイベントをリンクさせます。 イベント データは、メモリのブロックとして指定します。

protected:
 bool WriteTransferEvent(System::Diagnostics::Eventing::EventDescriptor % eventDescriptor, Guid relatedActivityId, int dataCount, IntPtr data);
[System.Security.SecurityCritical]
protected bool WriteTransferEvent (ref System.Diagnostics.Eventing.EventDescriptor eventDescriptor, Guid relatedActivityId, int dataCount, IntPtr data);
[<System.Security.SecurityCritical>]
member this.WriteTransferEvent : EventDescriptor * Guid * int * nativeint -> bool
Protected Function WriteTransferEvent (ByRef eventDescriptor As EventDescriptor, relatedActivityId As Guid, dataCount As Integer, data As IntPtr) As Boolean

パラメーター

eventDescriptor
EventDescriptor

書き込むイベントを識別する EventDescriptor のインスタンス。

relatedActivityId
Guid

直前のコンポーネントからの動作識別子。 このパラメーターを使用して、特定のコンポーネントのイベントを直前のコンポーネントのイベントにリンクさせます。

dataCount
Int32

data パラメーターが指すイベント データのサイズ。 イベント データの最大サイズは、64 KB からイベント ヘッダーのサイズを差し引いた値になります。 セッションのバッファー サイズが小さい場合や、イベントを含んだ拡張データ項目がセッションに存在する場合、イベント サイズはこれよりも小さくなります。

data
IntPtr

nativeint

書き込むイベント データへのポインター。

戻り値

イベントが書き込まれた場合は true。それ以外の場合は false。 false の場合は、GetLastWriteEventError() メソッドを呼び出すことで、失敗の原因を調べることができます。

属性

注釈

メソッドは、スレッド コンテキストで設定されたアクティビティ ID を使用して、このコンポーネントを識別します。 アクティビティ ID を設定するには、 メソッドを呼び出します SetActivityId

適用対象