EventProvider.WriteTransferEvent Methode

Definition

Namespace:

System.Diagnostics.Eventing

Assembly:

System.Core.dll

Verknüpft Ereignisse, wenn Ereignisse in einem End-to-End-Szenario nachverfolgt werden.

Überlädt

WriteTransferEvent(EventDescriptor, Guid, Object[])	Verknüpft Ereignisse, wenn Ereignisse in einem End-to-End-Szenario nachverfolgt werden. Die Ereignisdaten werden als Objektarray angegeben.
WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)	Verknüpft Ereignisse, wenn Ereignisse in einem End-to-End-Szenario nachverfolgt werden. Die Ereignisdaten werden als Speicherblock angegeben.

WriteTransferEvent(EventDescriptor, Guid, Object[])

Verknüpft Ereignisse, wenn Ereignisse in einem End-to-End-Szenario nachverfolgt werden. Die Ereignisdaten werden als Objektarray angegeben.

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

Parameter

eventDescriptor

EventDescriptor

Eine Instanz von EventDescriptor, die das zu schreibende Ereignis identifiziert.

relatedActivityId

Guid

Aktivitätsbezeichner aus der vorherigen Komponente. Verwenden Sie diesen Parameter, um die Ereignisse der Komponente mit den Ereignissen der vorherigen Komponente zu verknüpfen.

eventPayload

Object[]

Ein Array von Objekten, die die zu schreibenden Ereignisdaten enthalten. Die Daten müssen in der im Manifest angegebenen Reihenfolge angeordnet sein. Das Array ist auf 32 Objekte beschränkt, von denen nur acht Objekte Zeichenfolgen sein dürfen. Die maximale Datengröße für das Ereignis ist auf 64 KB abzüglich der Größe der Ereignisheader beschränkt. Die Ereignisgröße ist geringer, wenn die Puffergröße der Sitzung geringer ist und die Sitzung erweiterte Datenelemente für das Ereignis enthält.

Gibt zurück

Boolean

Ist true, wenn das Ereignis geschrieben wird, andernfalls false. Wenn der Wert false ist, rufen Sie die GetLastWriteEventError()-Methode auf, um die Ursache des Fehlers zu ermitteln.

Attribute

SecurityCriticalAttribute

Ausnahmen

ArgumentException

Wenn eventPayload zu viele Objekte oder Zeichenfolgen enthält.

Hinweise

Die -Methode verwendet die aktivitäts-ID, die im Threadkontext festgelegt ist, um diese Komponente zu identifizieren. Um die Aktivitäts-ID festzulegen, rufen Sie die -Methode auf SetActivityId .

Wenn Sie die Trace -Klasse verwenden, verwenden SetActivityId Sie die -Methode nicht, um die Aktivitäts-ID anzugeben. Greifen Sie stattdessen auf die CorrelationManager -Eigenschaft zu, um das CorrelationManager -Objekt abzurufen. Legen Sie dann die ActivityId -Eigenschaft auf die Aktivitäts-ID fest. Sie müssen auch den relatedActivityId auf einen ActivityId Wert festlegen.

WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)

Verknüpft Ereignisse, wenn Ereignisse in einem End-to-End-Szenario nachverfolgt werden. Die Ereignisdaten werden als Speicherblock angegeben.

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

Parameter

eventDescriptor

EventDescriptor

Eine Instanz von EventDescriptor, die das zu schreibende Ereignis identifiziert.

relatedActivityId

Guid

Aktivitätsbezeichner aus der vorherigen Komponente. Verwenden Sie diesen Parameter, um die Ereignisse der Komponente mit den Ereignissen der vorherigen Komponente zu verknüpfen.

dataCount

Int32

Die Größe der Ereignisdaten, auf die der data-Parameter zeigt. Die maximale Ereignisdatengröße ist auf 64 KB abzüglich der Größe der Ereignisheader beschränkt. Die Ereignisgröße ist geringer, wenn die Puffergröße der Sitzung geringer ist und die Sitzung erweiterte Datenelemente für das Ereignis enthält.

data

IntPtr

nativeint

Der Zeiger auf die zu schreibenden Ereignisdaten.

Gibt zurück

Boolean

Ist true, wenn das Ereignis geschrieben wird, andernfalls false. Wenn der Wert false ist, rufen Sie die GetLastWriteEventError()-Methode auf, um die Ursache des Fehlers zu ermitteln.

Attribute

SecurityCriticalAttribute

Hinweise

Die -Methode verwendet die aktivitäts-ID, die im Threadkontext festgelegt ist, um diese Komponente zu identifizieren. Um die Aktivitäts-ID festzulegen, rufen Sie die -Methode auf SetActivityId .