EventProvider.WriteTransferEvent Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Propojuje události při trasování událostí v komplexním scénáři.
Přetížení
WriteTransferEvent(EventDescriptor, Guid, Object[]) |
Propojuje události při trasování událostí v komplexním scénáři. Data události jsou určena jako pole objektů. |
WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr) |
Propojuje události při trasování událostí v komplexním scénáři. Data události jsou určena jako blok paměti. |
WriteTransferEvent(EventDescriptor, Guid, Object[])
Propojuje události při trasování událostí v komplexním scénáři. Data události jsou určena jako pole 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
Parametry
- eventDescriptor
- EventDescriptor
Instance EventDescriptor , která identifikuje událost k zápisu.
- relatedActivityId
- Guid
Identifikátor aktivity z předchozí komponenty. Tento parametr slouží k propojení událostí vaší komponenty s událostmi předchozí komponenty.
- eventPayload
- Object[]
Pole objektů, které obsahují data událostí k zápisu. Data musí být v pořadí zadaném v manifestu. Pole je omezeno na 32 objektů, z nichž pouze osm může být řetězce. Maximální velikost dat pro událost je omezena na 64 kB minus velikost hlaviček událostí. Velikost události je menší, pokud je velikost vyrovnávací paměti relace menší a relace zahrnuje rozšířené datové položky s událostí.
Návraty
Je true
, pokud je událost zapsána; v opačném případě false
. Pokud je false, zavolejte metodu GetLastWriteEventError() a určete příčinu selhání.
- Atributy
Výjimky
Pokud eventPayload
obsahuje příliš mnoho objektů nebo řetězců.
Poznámky
Metoda používá ID aktivity nastavené v kontextu vlákna k identifikaci této komponenty. Pokud chcete nastavit ID aktivity, zavolejte metodu SetActivityId .
Pokud použijete Trace třídu, nepoužijete metodu SetActivityId k zadání ID aktivity. Místo toho přejděte k CorrelationManager vlastnosti a získejte CorrelationManager objekt. Potom vlastnost nastavte ActivityId na ID aktivity. Musíte také nastavit relatedActivityId
hodnotu na ActivityId hodnotu.
Platí pro
WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)
Propojuje události při trasování událostí v komplexním scénáři. Data události jsou určena jako blok paměti.
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
Parametry
- eventDescriptor
- EventDescriptor
Instance EventDescriptor , která identifikuje událost k zápisu.
- relatedActivityId
- Guid
Identifikátor aktivity z předchozí komponenty. Tento parametr slouží k propojení událostí vaší komponenty s událostmi předchozí komponenty.
- dataCount
- Int32
Velikost dat události, na která data
parametr odkazuje. Maximální velikost dat událostí je omezena na 64 kB minus velikost hlaviček událostí. Velikost události je menší, pokud je velikost vyrovnávací paměti relace menší a relace zahrnuje rozšířené datové položky s událostí.
- data
-
IntPtr
nativeint
Ukazatel na data události, která se mají zapsat.
Návraty
Je true
, pokud je událost zapsána; v opačném případě false
. Pokud je false, zavolejte metodu GetLastWriteEventError() a určete příčinu selhání.
- Atributy
Poznámky
Metoda používá ID aktivity nastavené v kontextu vlákna k identifikaci této komponenty. Pokud chcete nastavit ID aktivity, zavolejte metodu SetActivityId .