Udostępnij za pośrednictwem


EventProvider.WriteTransferEvent Metoda

Definicja

Łączy zdarzenia razem podczas śledzenia zdarzeń w scenariuszu end-to-end.

Przeciążenia

WriteTransferEvent(EventDescriptor, Guid, Object[])

Łączy zdarzenia razem podczas śledzenia zdarzeń w scenariuszu end-to-end. Dane zdarzenia są określane jako tablica obiektów.

WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)

Łączy zdarzenia razem podczas śledzenia zdarzeń w scenariuszu end-to-end. Dane zdarzenia są określane jako blok pamięci.

WriteTransferEvent(EventDescriptor, Guid, Object[])

Łączy zdarzenia razem podczas śledzenia zdarzeń w scenariuszu end-to-end. Dane zdarzenia są określane jako tablica obiektów.

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

Wystąpienie klasy EventDescriptor identyfikuje zdarzenie do zapisania.

relatedActivityId
Guid

Identyfikator działania z poprzedniego składnika. Użyj tego parametru, aby połączyć zdarzenia składnika ze zdarzeniami poprzedniego składnika.

eventPayload
Object[]

Tablica obiektów, które zawierają dane zdarzenia do zapisania. Dane muszą być w kolejności określonej w manifeście. Tablica jest ograniczona do 32 obiektów, z których tylko osiem może być ciągami. Maksymalny rozmiar danych zdarzenia jest ograniczony do 64 KB pomniejszonego o rozmiar nagłówków zdarzeń. Rozmiar zdarzenia jest mniejszy, jeśli rozmiar buforu sesji jest mniejszy, a sesja zawiera rozszerzone elementy danych ze zdarzeniem.

Zwraca

Czy true zdarzenie jest zapisywane; w przeciwnym razie . false Jeśli wartość false, wywołaj metodę GetLastWriteEventError() , aby określić przyczynę błędu.

Atrybuty

Wyjątki

Jeśli eventPayload zawiera zbyt wiele obiektów lub ciągów.

Uwagi

Metoda używa zestawu identyfikatorów działań w kontekście wątku, aby zidentyfikować ten składnik. Aby ustawić identyfikator działania, wywołaj metodę SetActivityId .

Jeśli używasz Trace klasy , nie należy używać SetActivityId metody do określenia identyfikatora działania. Zamiast tego uzyskaj dostęp do CorrelationManager właściwości , aby uzyskać CorrelationManager obiekt . Następnie ustaw ActivityId właściwość na identyfikator działania. Należy również ustawić wartość relatedActivityId na ActivityId wartość .

Dotyczy

WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)

Łączy zdarzenia razem podczas śledzenia zdarzeń w scenariuszu end-to-end. Dane zdarzenia są określane jako blok pamięci.

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

Wystąpienie klasy EventDescriptor identyfikuje zdarzenie do zapisania.

relatedActivityId
Guid

Identyfikator działania z poprzedniego składnika. Użyj tego parametru, aby połączyć zdarzenia składnika ze zdarzeniami poprzedniego składnika.

dataCount
Int32

Rozmiar danych zdarzenia, do których data wskazuje parametr. Maksymalny rozmiar danych zdarzenia jest ograniczony do 64 KB pomniejszonego o rozmiar nagłówków zdarzeń. Rozmiar zdarzenia jest mniejszy, jeśli rozmiar buforu sesji jest mniejszy, a sesja zawiera rozszerzone elementy danych ze zdarzeniem.

data
IntPtr

nativeint

Wskaźnik do danych zdarzenia do zapisania.

Zwraca

Czy true zdarzenie jest zapisywane; w przeciwnym razie . false Jeśli wartość false, wywołaj metodę GetLastWriteEventError() , aby określić przyczynę błędu.

Atrybuty

Uwagi

Metoda używa zestawu identyfikatorów działań w kontekście wątku, aby zidentyfikować ten składnik. Aby ustawić identyfikator działania, wywołaj metodę SetActivityId .

Dotyczy