EventProvider.WriteTransferEvent EventProvider.WriteTransferEvent EventProvider.WriteTransferEvent EventProvider.WriteTransferEvent Method

Определение

Связывает события при сквозной трассировке.Links events together when tracing events in an end-to-end scenario.

Перегрузки

WriteTransferEvent(EventDescriptor, Guid, Object[]) WriteTransferEvent(EventDescriptor, Guid, Object[]) WriteTransferEvent(EventDescriptor, Guid, Object[]) WriteTransferEvent(EventDescriptor, Guid, Object[])

Связывает события при сквозной трассировке.Links events together when tracing events in an end-to-end scenario. Данные события указываются в виде массива объектов.The event data is specified as an array of objects.

WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr) WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr) WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr) WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)

Связывает события при сквозной трассировке.Links events together when tracing events in an end-to-end scenario. Данные события указаны в качестве блока памяти.The event data is specified as a block of memory.

WriteTransferEvent(EventDescriptor, Guid, Object[]) WriteTransferEvent(EventDescriptor, Guid, Object[]) WriteTransferEvent(EventDescriptor, Guid, Object[]) WriteTransferEvent(EventDescriptor, Guid, Object[])

Связывает события при сквозной трассировке.Links events together when tracing events in an end-to-end scenario. Данные события указываются в виде массива объектов.The event data is specified as an array of objects.

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);
member this.WriteTransferEvent :  * Guid * obj[] -> bool
Public Function WriteTransferEvent (ByRef eventDescriptor As EventDescriptor, relatedActivityId As Guid, ParamArray eventPayload As Object()) As Boolean

Параметры

eventDescriptor
EventDescriptor EventDescriptor EventDescriptor EventDescriptor

Экземпляр EventDescriptor, определяющий событие для записи.An instance of EventDescriptor that identifies the event to write.

relatedActivityId
Guid Guid Guid Guid

Идентификатор действия от предыдущего компонента.Activity identifier from the previous component. Этот параметр используется для связи событий компонента с событиями предыдущего компонента.Use this parameter to link your component's events to the previous component's events.

eventPayload
Object[]

Массив объектов, которые содержат данные записываемого события.An array of objects that contain the event data to write. Объекты должны быть в том порядке, который указан в манифесте.The data must be in the order specified in the manifest. Размер массива ограничен 32 объектами, из которых только 8 могут быть строчными.The array is limited to 32 objects, of which only eight may be strings. Максимальный размер данных события ограничен 64 КБ за вычетом размера заголовков события.The maximum data size for the event is limited to 64 KB minus the size of the event headers. Размер события может быть меньше, если меньше размер буфера сеанса и сеанс включает вместе c событием расширенные элементы данных.The event size is less if the session's buffer size is less and the session includes extended data items with the event.

Возвраты

Значение true, если событие записано, в противном случае — false.Is true if the event is written; otherwise, false. Если событие не записано, для определения причины сбоя можно использовать метод GetLastWriteEventError().If false, call the GetLastWriteEventError() method to determine the cause of the failure.

Исключения

Если параметр eventPayload содержит слишком много объектов или строк.If eventPayload contains too many objects or strings.

Комментарии

Метод использует идентификатор действия, заданный в контексте потока, для идентификации этого компонента.The method uses the activity ID set in the thread context to identify this component. Чтобы задать идентификатор действия, вызовите SetActivityId метод.To set the activity ID, call the SetActivityId method.

При использовании Trace класса SetActivityId метод не используется для указания идентификатора действия.If you use the Trace class, you do not use the SetActivityId method to specify the activity ID. Вместо этого CorrelationManager CorrelationManager получите доступ к свойству, чтобы получить объект.Instead, access the CorrelationManager property to get the CorrelationManager object. Затем задайте ActivityId для свойства Идентификатор действия.Then, set the ActivityId property to the activity ID. Необходимо также присвоить relatedActivityId свойству ActivityId значение.You must also set the relatedActivityId to a ActivityId value.

WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr) WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr) WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr) WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)

Связывает события при сквозной трассировке.Links events together when tracing events in an end-to-end scenario. Данные события указаны в качестве блока памяти.The event data is specified as a block of memory.

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);
member this.WriteTransferEvent :  * 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 EventDescriptor EventDescriptor

Экземпляр EventDescriptor, определяющий событие для записи.An instance of EventDescriptor that identifies the event to write.

relatedActivityId
Guid Guid Guid Guid

Идентификатор действия от предыдущего компонента.Activity identifier from the previous component. Этот параметр используется для связи событий компонента с событиями предыдущего компонента.Use this parameter to link your component's events to the previous component's events.

dataCount
Int32 Int32 Int32 Int32

Размер данных события, на которые указывает параметр data.Size of the event data to which the data parameter points. Максимальный размер данных события ограничен 64 КБ за вычетом размера заголовков события.The maximum event data size is limited to 64 KB minus the size of the event headers. Размер события может быть меньше, если меньше размер буфера сеанса и сеанс включает вместе c событием расширенные элементы данных.The event size is less if the session's buffer size is less and the session includes extended data items with the event.

data
IntPtr IntPtr IntPtr IntPtr

Указатель на данные события для записи.Pointer to the event data to write.

Возвраты

Значение true, если событие записано, в противном случае — false.Is true if the event is written; otherwise, false. Если событие не записано, для определения причины сбоя можно использовать метод GetLastWriteEventError().If false, call the GetLastWriteEventError() method to determine the cause of the failure.

Комментарии

Метод использует идентификатор действия, заданный в контексте потока, для идентификации этого компонента.The method uses the activity ID set in the thread context to identify this component. Чтобы задать идентификатор действия, вызовите SetActivityId метод.To set the activity ID, call the SetActivityId method.

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