EventProvider.WriteTransferEvent Método

Definição

Vincula os eventos durante o rastreamento de eventos em um cenário de ponta a ponta.Links events together when tracing events in an end-to-end scenario.

Sobrecargas

WriteTransferEvent(EventDescriptor, Guid, Object[])

Vincula os eventos durante o rastreamento de eventos em um cenário de ponta a ponta.Links events together when tracing events in an end-to-end scenario. Os dados de evento são especificados como uma matriz de objetos.The event data is specified as an array of objects.

WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)

Vincula os eventos durante o rastreamento de eventos em um cenário de ponta a ponta.Links events together when tracing events in an end-to-end scenario. Os dados de evento são especificados como um bloco de memória.The event data is specified as a block of memory.

WriteTransferEvent(EventDescriptor, Guid, Object[])

Vincula os eventos durante o rastreamento de eventos em um cenário de ponta a ponta.Links events together when tracing events in an end-to-end scenario. Os dados de evento são especificados como uma matriz de objetos.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);
[<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

Parâmetros

eventDescriptor
EventDescriptor

Uma instância de EventDescriptor que identifica o evento a ser gravado.An instance of EventDescriptor that identifies the event to write.

relatedActivityId
Guid

O identificador de atividade do componente anterior.Activity identifier from the previous component. Use esse parâmetro para vincular os eventos do componente para eventos do componente anterior.Use this parameter to link your component's events to the previous component's events.

eventPayload
Object[]

Uma matriz de objetos que contêm os dados do evento a ser gravado.An array of objects that contain the event data to write. Os dados precisam estar na ordem especificada no manifesto.The data must be in the order specified in the manifest. A matriz é limitada a 32 objetos, dos quais somente oito podem ser cadeias de caracteres.The array is limited to 32 objects, of which only eight may be strings. O tamanho máximo dos dados para o evento é limitado a 64 KB menos o tamanho dos cabeçalhos do evento.The maximum data size for the event is limited to 64 KB minus the size of the event headers. O tamanho do evento será menor se o tamanho do buffer da sessão for menor e a sessão incluir itens de dados estendidos com o evento.The event size is less if the session's buffer size is less and the session includes extended data items with the event.

Retornos

Boolean

É true se o evento for escrito; caso contrário, false.Is true if the event is written; otherwise, false. Se falso, chame o método GetLastWriteEventError() para determinar a causa da falha.If false, call the GetLastWriteEventError() method to determine the cause of the failure.

Atributos

Exceções

Se eventPayload contiver muitos objetos ou cadeias de caracteres.If eventPayload contains too many objects or strings.

Comentários

O método usa a ID da atividade definida no contexto do thread para identificar esse componente.The method uses the activity ID set in the thread context to identify this component. Para definir a ID da atividade, chame o SetActivityId método.To set the activity ID, call the SetActivityId method.

Se você usar a Trace classe, não use o SetActivityId método para especificar a ID da atividade.If you use the Trace class, you do not use the SetActivityId method to specify the activity ID. Em vez disso, acesse a CorrelationManager propriedade para obter o CorrelationManager objeto.Instead, access the CorrelationManager property to get the CorrelationManager object. Em seguida, defina a ActivityId propriedade para a ID da atividade.Then, set the ActivityId property to the activity ID. Você também deve definir relatedActivityId como um ActivityId valor.You must also set the relatedActivityId to a ActivityId value.

Aplica-se a

WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)

Vincula os eventos durante o rastreamento de eventos em um cenário de ponta a ponta.Links events together when tracing events in an end-to-end scenario. Os dados de evento são especificados como um bloco de memória.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);
[<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

Parâmetros

eventDescriptor
EventDescriptor

Uma instância de EventDescriptor que identifica o evento a ser gravado.An instance of EventDescriptor that identifies the event to write.

relatedActivityId
Guid

O identificador de atividade do componente anterior.Activity identifier from the previous component. Use esse parâmetro para vincular os eventos do componente para eventos do componente anterior.Use this parameter to link your component's events to the previous component's events.

dataCount
Int32

Tamanho dos dados do evento para o qual o parâmetro data aponta.Size of the event data to which the data parameter points. O tamanho máximo dos dados do evento é limitado a 64 KB menos o tamanho dos cabeçalhos do evento.The maximum event data size is limited to 64 KB minus the size of the event headers. O tamanho do evento será menor se o tamanho do buffer da sessão for menor e a sessão incluir itens de dados estendidos com o evento.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

Ponteiro para os dados de evento para gravação.Pointer to the event data to write.

Retornos

Boolean

É true se o evento for escrito; caso contrário, false.Is true if the event is written; otherwise, false. Se falso, chame o método GetLastWriteEventError() para determinar a causa da falha.If false, call the GetLastWriteEventError() method to determine the cause of the failure.

Atributos

Comentários

O método usa a ID da atividade definida no contexto do thread para identificar esse componente.The method uses the activity ID set in the thread context to identify this component. Para definir a ID da atividade, chame o SetActivityId método.To set the activity ID, call the SetActivityId method.

Aplica-se a