EventProvider.WriteTransferEvent Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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[] -> boolPublic Function WriteTransferEvent (ByRef eventDescriptor As EventDescriptor, relatedActivityId As Guid, ParamArray eventPayload As Object()) As BooleanParameter
- 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
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
Ausnahmen
Wenn eventPayload zu viele Objekte oder Zeichenfolgen enthält.
Hinweise
Die -Methode verwendet die im Threadkontext festgelegte Aktivitäts-ID, um diese Komponente zu identifizieren. Rufen Sie die -Methode auf, um die Aktivitäts-ID SetActivityId festzulegen.
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 auf relatedActivityId einen ActivityId Wert festlegen.
Gilt für:
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 -> boolProtected Function WriteTransferEvent (ByRef eventDescriptor As EventDescriptor, relatedActivityId As Guid, dataCount As Integer, data As IntPtr) As BooleanParameter
- 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
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
Hinweise
Die -Methode verwendet die im Threadkontext festgelegte Aktivitäts-ID, um diese Komponente zu identifizieren. Rufen Sie die -Methode auf, um die Aktivitäts-ID SetActivityId festzulegen.
