EventProvider.WriteTransferEvent Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Länkar händelser till varandra när händelser spåras i ett scenario från slutpunkt till slutpunkt.
Överlagringar
| Name | Description |
|---|---|
| WriteTransferEvent(EventDescriptor, Guid, Object[]) |
Länkar händelser till varandra när händelser spåras i ett scenario från slutpunkt till slutpunkt. Händelsedata anges som en matris med objekt. |
| WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr) |
Länkar händelser till varandra när händelser spåras i ett scenario från slutpunkt till slutpunkt. Händelsedata anges som ett minnesblock. |
WriteTransferEvent(EventDescriptor, Guid, Object[])
Länkar händelser till varandra när händelser spåras i ett scenario från slutpunkt till slutpunkt. Händelsedata anges som en matris med objekt.
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
Parametrar
- eventDescriptor
- EventDescriptor
En instans av EventDescriptor som identifierar händelsen som ska skrivas.
- relatedActivityId
- Guid
Aktivitetsidentifierare från föregående komponent. Använd den här parametern för att länka komponentens händelser till den tidigare komponentens händelser.
- eventPayload
- Object[]
En matris med objekt som innehåller de händelsedata som ska skrivas. Data måste vara i den ordning som anges i manifestet. Matrisen är begränsad till 32 objekt, varav endast åtta kan vara strängar. Den maximala datastorleken för händelsen är begränsad till 64 KB minus storleken på händelserubrikerna. Händelsestorleken är mindre om sessionens buffertstorlek är mindre och sessionen innehåller utökade dataobjekt med händelsen.
Returer
Är true om händelsen skrivs, annars . false Om det är falskt anropar du GetLastWriteEventError() metoden för att fastställa orsaken till felet.
- Attribut
Undantag
Om eventPayload innehåller för många objekt eller strängar.
Kommentarer
Metoden använder aktivitets-ID:t i trådkontexten för att identifiera den här komponenten. Om du vill ange aktivitets-ID:t anropar du SetActivityId metoden.
Om du använder Trace klassen använder SetActivityId du inte metoden för att ange aktivitets-ID:t. Öppna CorrelationManager i stället egenskapen för att hämta CorrelationManager objektet. Ange ActivityId sedan egenskapen till aktivitets-ID. Du måste också ange relatedActivityId värdet till ett ActivityId värde.
Gäller för
WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)
Länkar händelser till varandra när händelser spåras i ett scenario från slutpunkt till slutpunkt. Händelsedata anges som ett minnesblock.
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
Parametrar
- eventDescriptor
- EventDescriptor
En instans av EventDescriptor som identifierar händelsen som ska skrivas.
- relatedActivityId
- Guid
Aktivitetsidentifierare från föregående komponent. Använd den här parametern för att länka komponentens händelser till den tidigare komponentens händelser.
- dataCount
- Int32
Storleken på de händelsedata som parametern pekar på data . Den maximala händelsedatastorleken är begränsad till 64 KB minus storleken på händelserubrikerna. Händelsestorleken är mindre om sessionens buffertstorlek är mindre och sessionen innehåller utökade dataobjekt med händelsen.
- data
-
IntPtr
nativeint
Pekare till de händelsedata som ska skrivas.
Returer
Är true om händelsen skrivs, annars . false Om det är falskt anropar du GetLastWriteEventError() metoden för att fastställa orsaken till felet.
- Attribut
Kommentarer
Metoden använder aktivitets-ID:t i trådkontexten för att identifiera den här komponenten. Om du vill ange aktivitets-ID:t anropar du SetActivityId metoden.