EventWrittenEventArgs Klasa

Definicja

Przestrzeń nazw:

System.Diagnostics.Tracing

Zestaw:

System.Diagnostics.Tracing.dll

Zestaw:

mscorlib.dll

Zestaw:

netstandard.dll

Udostępnia dane dla wywołania zwrotnego OnEventWritten(EventWrittenEventArgs) .

public ref class EventWrittenEventArgs : EventArgs

public class EventWrittenEventArgs : EventArgs

type EventWrittenEventArgs = class
    inherit EventArgs

Public Class EventWrittenEventArgs
Inherits EventArgs

Dziedziczenie

Object

EventArgs

EventWrittenEventArgs

Uwagi

Za każdym razem, gdy zdarzenie jest wysyłane do metody EventListenerwywołania zwrotnego, EventListener.OnEventWritten wywoływana jest metoda wywołania zwrotnego. Jest przekazywane EventWrittenEventArgs wystąpienie zawierające informacje skojarzone ze zdarzeniem. Wszystkie wartości EventWrittenEventArgs właściwości klasy są prawidłowe tylko podczas wywołania zwrotnego.

Poniższe sekcje zawierają dodatkowe informacje o poszczególnych EventWrittenEventArgs właściwościach.

Właściwość ActivityId

W przypadku używania System.Activities.Activity i jego klas pochodnych wątki można oznaczyć jako skojarzone z nimi działanie. Właściwość ActivityId zwraca identyfikator działania wątku, który zarejestrował zdarzenie. Należy pamiętać, że wątki nie muszą mieć działania, w takim przypadku ta właściwość zwraca Guid.Emptywartość .

Właściwości OSThreadId i TimeStamp

Począwszy od platformy .NET Core 2.2, EventListener obiekty mogą subskrybować natywne zdarzenia środowiska uruchomieniowego (takie jak zdarzenia GC, JIT i threadpool) oprócz zdarzeń emitowanych przez EventSource obiekty. W poprzednich wersjach platformy .NET Core i wszystkich wersjach .NET Framework identyfikator wątku i znacznik czasu można zebrać ze środowiska, ponieważ są one wysyłane synchronicznie w tym samym wątku, który je emitował. Nie wszystkie natywne zdarzenia środowiska uruchomieniowego można jednak wysyłać synchronicznie. Niektóre zdarzenia, takie jak zdarzenia GC, są emitowane, gdy wykonywanie zarządzanego wątku jest zawieszone. Te zdarzenia są buforowane w kodzie natywnym i są wysyłane przez wątek dyspozytora po ponownym wykonaniu kodu zarządzanego. Ponieważ te zdarzenia są buforowane, środowisko nie może być używane do niezawodnego pobierania identyfikatora wątku i znacznika czasu. W związku z tym, począwszy od platformy .NET Core 2.2, informacje o identyfikatorze wątku i sygnaturze EventWrittenEventArgs czasowej są dostępne jako elementy członkowskie klasy.

Właściwość RelatedActivityId

Powiązane działanie to działanie, które jest silnie związane z bieżącym działaniem. Zazwyczaj jest to działanie, które spowodowało bieżące działanie (zdarzenia z Start kodem opcode zwykle to robią) lub działanie utworzone przez bieżący (zdarzenia z Send kodem opcode zwykle to robią). Gdy jest używany, RelatedActivityID metoda jest jawnie przekazywana przez metodę wykonującą rejestrowanie. Wiele zdarzeń nie przekazuje obiektu RelatedActivityId, w którym przypadku ta właściwość zwraca Guid.Emptywartość .

Właściwości

ActivityId	Pobiera identyfikator działania w wątku, do którego zostało zapisane zdarzenie.
Channel	Pobiera kanał dla zdarzenia.
EventId	Pobiera identyfikator zdarzenia.
EventName	Pobiera nazwę zdarzenia.
EventSource	Pobiera obiekt źródła zdarzeń.
Keywords	Pobiera słowa kluczowe zdarzenia.
Level	Pobiera poziom zdarzenia.
Message	Pobiera komunikat dla zdarzenia.
Opcode	Pobiera kod operacji dla zdarzenia.
OSThreadId	Pobiera identyfikator wątku dla wątku systemu operacyjnego, który napisał zdarzenie. (tylko platforma .NET Core 2.2 lub nowsza).
Payload	Pobiera ładunek zdarzenia.
PayloadNames	Zwraca listę ciągów reprezentujących nazwy właściwości zdarzenia.
RelatedActivityId	Pobiera identyfikator działania powiązanego z działaniem reprezentowanym przez bieżące wystąpienie.
Tags	Zwraca tagi określone w wywołaniu metody Write(String, EventSourceOptions) .
Task	Pobiera zadanie zdarzenia.
TimeStamp	Pobiera czas, przez który zdarzenie zostało pierwotnie wygenerowane jako sygnatura czasowa DateTime . (tylko platforma .NET Core 2.2 lub nowsza).
Version	Pobiera wersję zdarzenia.

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)