EventProvider.WriteTransferEvent Metoda

Definicja

Przestrzeń nazw:

System.Diagnostics.Eventing

Zestaw:

System.Core.dll

Łą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

Boolean

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

Atrybuty

SecurityCriticalAttribute

Wyjątki

ArgumentException

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ść .

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

Boolean

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

Atrybuty

SecurityCriticalAttribute

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 .