EventWrittenEventArgs EventWrittenEventArgs EventWrittenEventArgs EventWrittenEventArgs Class

Определение

Предоставляет данные для обратного вызова OnEventWritten(EventWrittenEventArgs).Provides data for the OnEventWritten(EventWrittenEventArgs) callback.

public ref class EventWrittenEventArgs : EventArgs
public class EventWrittenEventArgs : EventArgs
type EventWrittenEventArgs = class
    inherit EventArgs
Public Class EventWrittenEventArgs
Inherits EventArgs
Наследование
EventWrittenEventArgsEventWrittenEventArgsEventWrittenEventArgsEventWrittenEventArgs

Комментарии

При каждом отправке события в объект EventListener EventListener.OnEventWritten вызывается метод обратного вызова.Whenever an event is dispatched to an EventListener, the EventListener.OnEventWritten callback method is invoked. Ему передается EventWrittenEventArgs экземпляр, содержащий сведения, связанные с событием.It is passed an EventWrittenEventArgs instance that contains information associated with the event. Все значения EventWrittenEventArgs свойств класса допустимы только во время обратного вызова.All property values of the EventWrittenEventArgs class are valid only during the callback.

В следующих разделах содержатся дополнительные сведения об отдельных EventWrittenEventArgs свойствах.The following sections contain additional information about individual EventWrittenEventArgs properties.

ActivityId, свойствоActivityId property

При использовании System.Activities.Activity и производных от него классов потоки могут быть помечены как имеющие связанное с ними действие.When using System.Activities.Activity and its derived classes, threads can be marked as having an activity associated with them. ActivityId Свойство возвращает идентификатор действия потока, который зарегистрировал событие.The ActivityId property returns the activity ID of the thread that logged the event. Обратите внимание, что потоки не обязательно должны иметь действие, в этом случае это свойство Guid.Emptyвозвращает значение.Note that threads do not have to have an activity, in which case this property returns Guid.Empty.

Свойства Оссреадид и TimeStampOSThreadId and TimeStamp properties

Начиная с .NET Core 2,2, EventListener объекты могут подписываться на собственные события среды выполнения (такие как события GC, JIT и ThreadPool) в дополнение к событиям EventSource , создаваемым объектами.Starting with .NET Core 2.2, EventListener objects can subscribe to native runtime events (such as GC, JIT, and threadpool events) in addition to events emitted by EventSource objects. В предыдущих версиях .NET Core и всех версиях .NET Framework идентификатор потока и отметка времени могут быть собраны из среды, так как они отправляются синхронно в том же потоке, который их выдал.In previous versions of .NET Core and all versions of .NET Framework, the thread ID and timestamp can be gathered from the environment, because they are dispatched synchronously on the same thread that emitted them. Однако не все собственные события среды выполнения могут быть отправлены синхронно.Not all native runtime events can be dispatched synchronously, however. Некоторые события, такие как события сборки мусора, создаются при приостановке выполнения управляемого потока.Some events, such as GC events, are emitted when managed thread execution is suspended. Эти события буферизуются в машинном коде и отправляются потоком Dispatcher после того, как управляемый код может снова выполниться.These events are buffered in native code and are dispatched by a dispatcher thread once managed code can execute again. Так как эти события буферизованы, среду нельзя использовать для надежного получения идентификатора потока и метки времени.Because these events are buffered, the environment cannot be used to reliably retrieve the thread ID and timestamp. По этой причине начиная с .NET Core 2,2 сведения о идентификаторе потока и метке времени доступны как члены EventWrittenEventArgs класса.Because of this, starting with .NET Core 2.2, thread ID and timestamp information are available as members of the EventWrittenEventArgs class.

RelatedActivityId, свойствоRelatedActivityId property

Связанное действие — это действие, которое строго связано с текущим.A related activity is an activity that is strongly related to the current one. Как правило, это либо действие, вызвавшее текущее действие (обычно события с Start помощью кода операции), либо действие, которое было создано текущим (события Send с кодом операции, как правило).Typically, it is either the activity that caused the current activity (events with the Start opcode typically do this) or an activity that was created by the current one (events with the Send opcode typically do this). При использовании RelatedActivityID метод явно передается методом, выполняющим ведение журнала.When it is used, the RelatedActivityID is explicitly passed by the method doing the logging. Многие события не передаются RelatedActivityId, в этом случае это свойство возвращает Guid.Emptyзначение.Many events don't pass a RelatedActivityId, in which case this property returns Guid.Empty.

Свойства

ActivityId ActivityId ActivityId ActivityId

Получает идентификатор действия в потоке, куда было записано событие.Gets the activity ID on the thread that the event was written to.

Channel Channel Channel Channel

Возвращает канал события.Gets the channel for the event.

EventId EventId EventId EventId

Возвращает идентификатор события.Gets the event identifier.

EventName EventName EventName EventName

Получение имени события.Gets the name of the event.

EventSource EventSource EventSource EventSource

Получает объект источника события.Gets the event source object.

Keywords Keywords Keywords Keywords

Получает ключевые слова для события.Gets the keywords for the event.

Level Level Level Level

Получает уровень события.Gets the level of the event.

Message Message Message Message

Получает сообщение для события.Gets the message for the event.

Opcode Opcode Opcode Opcode

Получает код операции для события.Gets the operation code for the event.

OSThreadId OSThreadId OSThreadId OSThreadId

Получает идентификатор потока для потока операционной системы, который записал событие.Gets the thread identifier for the OS thread that wrote the event. (.NET Core 2.2 и более поздних версий.)(.NET Core 2.2 and later only.)

Payload Payload Payload Payload

Получает полезные данные для события.Gets the payload for the event.

PayloadNames PayloadNames PayloadNames PayloadNames

Возвращает список строк, представляющих имена свойств события.Returns a list of strings that represent the property names of the event.

RelatedActivityId RelatedActivityId RelatedActivityId RelatedActivityId

Возвращает идентификатор действия, которое связано с действием, представленное текущим экземпляром.Gets the identifier of an activity that is related to the activity represented by the current instance.

Tags Tags Tags Tags

Возвращает указанные теги в вызове метода Write(String, EventSourceOptions).Returns the tags specified in the call to the Write(String, EventSourceOptions) method.

Task Task Task Task

Получает задачу для события.Gets the task for the event.

TimeStamp TimeStamp TimeStamp TimeStamp

Получает время, в которое изначально было создано событие, как метку времени DateTime.Gets the time that the event was originally generated as a DateTime timestamp. (.NET Core 2.2 и более поздних версий.)(.NET Core 2.2 and later only.)

Version Version Version Version

Получает версию события.Gets the version of the event.

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

Применяется к