EventProvider.WriteTransferEvent Método

Definição

Espaço de Nomes:: System.Diagnostics.Eventing

Assemblagem:: System.Core.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Liga eventos ao traçar eventos num cenário de ponta a ponta.

Sobrecargas

Name	Description
WriteTransferEvent(EventDescriptor, Guid, Object[])	Liga eventos ao traçar eventos num cenário de ponta a ponta. Os dados do evento são especificados como um array de objetos.
WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)	Liga eventos ao traçar eventos num cenário de ponta a ponta. Os dados do evento são especificados como um bloco de memória.

WriteTransferEvent(EventDescriptor, Guid, Object[])

Liga eventos ao traçar eventos num cenário de ponta a ponta. Os dados do evento são especificados como um array 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 disso EventDescriptor identifica o evento a escrever.

relatedActivityId: Guid

Identificador de atividade do componente anterior. Use este parâmetro para ligar os eventos do seu componente aos eventos do componente anterior.

eventPayload: Object[]

Um array de objetos que contêm os dados do evento a escrever. Os dados devem estar na ordem especificada no manifesto. O array está limitado a 32 objetos, dos quais apenas oito podem ser cadeias. 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 é menor se o buffer da sessão for menor e a sessão incluir itens de dados estendidos com o evento.

Devoluções

Boolean

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

Atributos: SecurityCriticalAttribute

Exceções

ArgumentException

Se eventPayload contém demasiados objetos ou strings.

Observações

O método utiliza o ID de atividade definido no contexto do thread para identificar este componente. Para definir o ID da atividade, chame o SetActivityId método.

Se usares a Trace classe, não usas o SetActivityId método para especificar o ID da atividade. Em vez disso, acede à CorrelationManager propriedade para obter o CorrelationManager objeto. Depois, defina a ActivityId propriedade para o ID da atividade. Também deve definir o relatedActivityId para um ActivityId valor.

Aplica-se a

WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)

Liga eventos ao traçar eventos num cenário de ponta a ponta. Os dados do 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 disso EventDescriptor identifica o evento a escrever.

relatedActivityId: Guid

Identificador de atividade do componente anterior. Use este parâmetro para ligar os eventos do seu componente aos eventos do componente anterior.

dataCount: Int32

Tamanho dos dados do evento para os quais o data parâmetro 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 é menor se o buffer da sessão for menor e a sessão incluir itens de dados estendidos com o evento.

data: IntPtr
nativeint

Apontar para os dados do evento a escrever.