EventProvider.WriteTransferEvent メソッド

定義

名前空間:

System.Diagnostics.Eventing

アセンブリ:

System.Core.dll

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

オーバーロード

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 からイベント ヘッダーのサイズを差し引いた値になります。 セッションのバッファー サイズが小さい場合や、イベントを含んだ拡張データ項目がセッションに存在する場合、イベント サイズはこれよりも小さくなります。

戻り値

Boolean

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

属性

SecurityCriticalAttribute

例外

ArgumentException

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

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

戻り値

Boolean

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

属性

SecurityCriticalAttribute

注釈

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