Поделиться через


EventProvider.WriteTransferEvent Метод

Определение

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

Перегрузки

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 событием расширенные элементы данных.

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

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

Атрибуты

Исключения

Если параметр 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

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

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

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

Атрибуты

Комментарии

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

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