EventProvider.WriteTransferEvent Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Koppelt gebeurtenissen aan elkaar bij het traceren van gebeurtenissen in een end-to-end scenario.
Overloads
| Name | Description |
|---|---|
| WriteTransferEvent(EventDescriptor, Guid, Object[]) |
Koppelt gebeurtenissen aan elkaar bij het traceren van gebeurtenissen in een end-to-end scenario. De gebeurtenisgegevens worden opgegeven als een matrix met objecten. |
| WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr) |
Koppelt gebeurtenissen aan elkaar bij het traceren van gebeurtenissen in een end-to-end scenario. De gebeurtenisgegevens worden opgegeven als een blok geheugen. |
WriteTransferEvent(EventDescriptor, Guid, Object[])
Koppelt gebeurtenissen aan elkaar bij het traceren van gebeurtenissen in een end-to-end scenario. De gebeurtenisgegevens worden opgegeven als een matrix met objecten.
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 BooleanParameters
- eventDescriptor
- EventDescriptor
Een instantie van EventDescriptor die identificeert de gebeurtenis die moet worden geschreven.
- relatedActivityId
- Guid
Activiteits-id van het vorige onderdeel. Gebruik deze parameter om de gebeurtenissen van uw onderdeel te koppelen aan de gebeurtenissen van het vorige onderdeel.
- eventPayload
- Object[]
Een matrix met objecten die de gebeurtenisgegevens bevatten die moeten worden geschreven. De gegevens moeten de volgorde hebben die is opgegeven in het manifest. De matrix is beperkt tot 32 objecten, waarvan slechts acht tekenreeksen mogen zijn. De maximale gegevensgrootte voor de gebeurtenis is beperkt tot 64 kB min de grootte van de gebeurtenisheaders. De gebeurtenisgrootte is kleiner als de buffergrootte van de sessie kleiner is en de sessie uitgebreide gegevensitems bevat met de gebeurtenis.
Retouren
Is true als de gebeurtenis is geschreven; anders. false Als dit onwaar is, roept u de GetLastWriteEventError() methode aan om de oorzaak van de fout te bepalen.
- Kenmerken
Uitzonderingen
Als eventPayload er te veel objecten of tekenreeksen zijn.
Opmerkingen
De methode gebruikt de activiteits-id die is ingesteld in de threadcontext om dit onderdeel te identificeren. Als u de activiteits-id wilt instellen, roept u de SetActivityId methode aan.
Als u de Trace klasse gebruikt, gebruikt u de SetActivityId methode niet om de activiteits-id op te geven. Open in plaats daarvan de CorrelationManager eigenschap om het CorrelationManager object op te halen. Stel vervolgens de ActivityId eigenschap in op de activiteits-id. U moet ook de relatedActivityId waarde instellen op een ActivityId waarde.
Van toepassing op
WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)
Koppelt gebeurtenissen aan elkaar bij het traceren van gebeurtenissen in een end-to-end scenario. De gebeurtenisgegevens worden opgegeven als een blok geheugen.
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 BooleanParameters
- eventDescriptor
- EventDescriptor
Een instantie van EventDescriptor die identificeert de gebeurtenis die moet worden geschreven.
- relatedActivityId
- Guid
Activiteits-id van het vorige onderdeel. Gebruik deze parameter om de gebeurtenissen van uw onderdeel te koppelen aan de gebeurtenissen van het vorige onderdeel.
- dataCount
- Int32
Grootte van de gebeurtenisgegevens waarnaar de data parameter verwijst. De maximale grootte van gebeurtenisgegevens is beperkt tot 64 kB min de grootte van de gebeurtenisheaders. De gebeurtenisgrootte is kleiner als de buffergrootte van de sessie kleiner is en de sessie uitgebreide gegevensitems bevat met de gebeurtenis.
- data
-
IntPtr
nativeint
Wijs de gebeurtenisgegevens aan die moeten worden geschreven.
Retouren
Is true als de gebeurtenis is geschreven; anders. false Als dit onwaar is, roept u de GetLastWriteEventError() methode aan om de oorzaak van de fout te bepalen.
- Kenmerken
Opmerkingen
De methode gebruikt de activiteits-id die is ingesteld in de threadcontext om dit onderdeel te identificeren. Als u de activiteits-id wilt instellen, roept u de SetActivityId methode aan.
