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[] -> boolPublic Function WriteTransferEvent (ByRef eventDescriptor As EventDescriptor, relatedActivityId As Guid, ParamArray eventPayload As Object()) As BooleanПараметры
- eventDescriptor
- EventDescriptor
Экземпляр, определяющий EventDescriptor событие для записи.
- relatedActivityId
- Guid
Идентификатор действия из предыдущего компонента. Используйте этот параметр, чтобы связать события компонента с событиями предыдущего компонента.
- eventPayload
- Object[]
Массив объектов, содержащих данные события для записи. Данные должны находиться в порядке, указанном в манифесте. Массив ограничен 32 объектами, из которых могут быть только восемь строк. Максимальный размер данных для события ограничен 64 КБ минус размер заголовков событий. Размер события меньше, если размер буфера сеанса меньше, а сеанс включает расширенные элементы данных с событием.
Возвращаемое значение
Значение , если true событие записывается; в противном случае false. Если значение false, вызовите GetLastWriteEventError() метод, чтобы определить причину сбоя.
- Атрибуты
Исключения
Если eventPayload содержит слишком много объектов или строк.
Комментарии
Метод использует идентификатор действия, заданный в контексте потока, для идентификации этого компонента. Чтобы задать идентификатор действия, вызовите SetActivityId метод.
Если вы используете класс, метод не используется SetActivityId для указания идентификатора Trace действия. Вместо этого получите доступ к свойству CorrelationManagerCorrelationManager , чтобы получить объект. Затем задайте ActivityId для свойства идентификатор действия. Необходимо также задать relatedActivityId значение ActivityId .
Применяется к
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 -> boolProtected 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 КБ минус размер заголовков событий. Размер события меньше, если размер буфера сеанса меньше, а сеанс включает расширенные элементы данных с событием.
- data
-
IntPtr
nativeint
Указатель на данные события для записи.
Возвращаемое значение
Значение , если true событие записывается; в противном случае false. Если значение false, вызовите GetLastWriteEventError() метод, чтобы определить причину сбоя.
- Атрибуты
Комментарии
Метод использует идентификатор действия, заданный в контексте потока, для идентификации этого компонента. Чтобы задать идентификатор действия, вызовите SetActivityId метод.
