EventProvider.WriteTransferEvent Метод

Определение

Пространство имен:

System.Diagnostics.Eventing

Сборка:

System.Core.dll

Связывает события при сквозной трассировке.

Перегрузки

WriteTransferEvent(EventDescriptor, Guid, Object[])	Связывает события при сквозной трассировке. Данные события указываются в виде массива объектов.
WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)	Связывает события при сквозной трассировке. Данные события указаны в качестве блока памяти.

WriteTransferEvent(EventDescriptor, Guid, Object[])

Связывает события при сквозной трассировке. Данные события указываются в виде массива объектов.

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

Параметры

eventDescriptor

EventDescriptor

Экземпляр EventDescriptor, определяющий событие для записи.

relatedActivityId

Guid

Идентификатор действия от предыдущего компонента. Этот параметр используется для связи событий компонента с событиями предыдущего компонента.

eventPayload

Object[]

Массив объектов, которые содержат данные записываемого события. Объекты должны быть в том порядке, который указан в манифесте. Размер массива ограничен 32 объектами, из которых только 8 могут быть строчными. Максимальный размер данных события ограничен 64 КБ за вычетом размера заголовков события. Размер события может быть меньше, если меньше размер буфера сеанса и сеанс включает вместе c событием расширенные элементы данных.

Возвращаемое значение

Boolean

Значение true, если событие записано, в противном случае — false. Если событие не записано, для определения причины сбоя можно использовать метод GetLastWriteEventError().

Атрибуты

SecurityCriticalAttribute

Исключения

ArgumentException

Если параметр eventPayload содержит слишком много объектов или строк.

Комментарии

Метод использует идентификатор действия, заданный в контексте потока, для идентификации этого компонента. Чтобы задать идентификатор действия, вызовите SetActivityId метод .

Если вы используете Trace класс , вы не используете SetActivityId метод для указания идентификатора действия. Вместо этого получите доступ к свойству CorrelationManagerCorrelationManager , чтобы получить объект . Затем задайте для ActivityId свойства идентификатор действия. Также необходимо задать relatedActivityIdActivityId для значение .

WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)

Связывает события при сквозной трассировке. Данные события указаны в качестве блока памяти.

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

Параметры

eventDescriptor

EventDescriptor

Экземпляр EventDescriptor, определяющий событие для записи.

relatedActivityId

Guid

Идентификатор действия от предыдущего компонента. Этот параметр используется для связи событий компонента с событиями предыдущего компонента.

dataCount

Int32

Размер данных события, на которые указывает параметр data. Максимальный размер данных события ограничен 64 КБ за вычетом размера заголовков события. Размер события может быть меньше, если меньше размер буфера сеанса и сеанс включает вместе c событием расширенные элементы данных.

data

IntPtr

nativeint

Указатель на данные события для записи.

Возвращаемое значение

Boolean

Значение true, если событие записано, в противном случае — false. Если событие не записано, для определения причины сбоя можно использовать метод GetLastWriteEventError().

Атрибуты

SecurityCriticalAttribute

Комментарии

Метод использует идентификатор действия, заданный в контексте потока, для идентификации этого компонента. Чтобы задать идентификатор действия, вызовите SetActivityId метод .