EventWrittenEventArgs Класс

Определение

Предоставляет данные для обратного вызова 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
Наследование
EventWrittenEventArgs

Комментарии

При каждом отправке события в объект 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

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

Channel

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

EventId

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

EventName

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

EventSource

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

Keywords

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

Level

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

Message

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

Opcode

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

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

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

PayloadNames

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

RelatedActivityId

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

Tags

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

Task

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

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

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

Методы

Equals(Object)

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

(Унаследовано от Object)
GetHashCode()

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

(Унаследовано от Object)
GetType()

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

(Унаследовано от Object)
MemberwiseClone()

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

(Унаследовано от Object)
ToString()

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

(Унаследовано от Object)

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