EventProvider.WriteTransferEvent Método

Definição

Namespace:

System.Diagnostics.Eventing

Assembly:

System.Core.dll

Vincula os eventos durante o rastreamento de eventos em um cenário de ponta a ponta.

Sobrecargas

WriteTransferEvent(EventDescriptor, Guid, Object[])	Vincula os eventos durante o rastreamento de eventos em um cenário de ponta a ponta. Os dados de evento são especificados como uma matriz de objetos.
WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)	Vincula os eventos durante o rastreamento de eventos em um cenário de ponta a ponta. Os dados de evento são especificados como um bloco de memória.

WriteTransferEvent(EventDescriptor, Guid, Object[])

Vincula os eventos durante o rastreamento de eventos em um cenário de ponta a ponta. Os dados de evento são especificados como uma matriz de objetos.

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.

relatedActivityId

Guid

O identificador de atividade do componente anterior. Use esse parâmetro para vincular os eventos do componente para eventos do componente anterior.

eventPayload

Object[]

Uma matriz de objetos que contêm os dados do evento a ser gravado. Os dados precisam estar na ordem especificada no manifesto. A matriz é limitada a 32 objetos, dos quais somente oito podem ser cadeias de caracteres. O tamanho máximo dos dados para o evento é limitado a 64 KB menos o tamanho dos cabeçalhos do evento. 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.

Retornos

Boolean

É true se o evento for escrito; caso contrário, false. Se falso, chame o método GetLastWriteEventError() para determinar a causa da falha.

Atributos

SecurityCriticalAttribute

Exceções

ArgumentException

Se eventPayload contiver muitos objetos ou cadeias de caracteres.

Comentários

O método usa a ID de atividade definida no contexto do thread para identificar esse componente. Para definir a ID da atividade, chame o SetActivityId método .

Se você usar a Trace classe , não usará o SetActivityId método para especificar a ID da atividade. Em vez disso, acesse a CorrelationManager propriedade para obter o CorrelationManager objeto . Em seguida, defina a ActivityId propriedade como a ID da atividade. Você também deve definir o relatedActivityId como um ActivityId valor.

WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)

Vincula os eventos durante o rastreamento de eventos em um cenário de ponta a ponta. Os dados de evento são especificados como um bloco de memória.

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.

relatedActivityId

Guid

O identificador de atividade do componente anterior. Use esse parâmetro para vincular os eventos do componente para eventos do componente anterior.

dataCount

Int32

Tamanho dos dados do evento para o qual o parâmetro data aponta. O tamanho máximo dos dados do evento é limitado a 64 KB menos o tamanho dos cabeçalhos do evento. 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.

data

IntPtr

nativeint

Ponteiro para os dados de evento para gravação.

Retornos

Boolean

É true se o evento for escrito; caso contrário, false. Se falso, chame o método GetLastWriteEventError() para determinar a causa da falha.

Atributos

SecurityCriticalAttribute

Comentários

O método usa a ID de atividade definida no contexto do thread para identificar esse componente. Para definir a ID da atividade, chame o SetActivityId método .