EventProvider.WriteTransferEvent Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Vincula eventos ao rastrear eventos em um cenário de ponta a ponta.
Sobrecargas
| Nome | Description |
|---|---|
| WriteTransferEvent(EventDescriptor, Guid, Object[]) |
Vincula eventos ao rastrear eventos em um cenário de ponta a ponta. Os dados do evento são especificados como uma matriz de objetos. |
| WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr) |
Vincula eventos ao rastrear eventos em um cenário de ponta a ponta. Os dados do evento são especificados como um bloco de memória. |
WriteTransferEvent(EventDescriptor, Guid, Object[])
Vincula eventos ao rastrear eventos em um cenário de ponta a ponta. Os dados do 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[] -> boolPublic Function WriteTransferEvent (ByRef eventDescriptor As EventDescriptor, relatedActivityId As Guid, ParamArray eventPayload As Object()) As BooleanParâmetros
- eventDescriptor
- EventDescriptor
Uma instância desse EventDescriptor tipo identifica o evento a ser gravado.
- relatedActivityId
- Guid
Identificador de atividade do componente anterior. Use esse parâmetro para vincular os eventos do componente aos eventos do componente anterior.
- eventPayload
- Object[]
Uma matriz de objetos que contêm os dados de evento a serem gravados. Os dados devem estar na ordem especificada no manifesto. A matriz é limitada a 32 objetos, dos quais apenas oito podem ser cadeias de caracteres. O tamanho máximo dos dados do evento é limitado a 64 KB menos o tamanho dos cabeçalhos de 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
É true se o evento for gravado; caso contrário, false. Se for falso, chame o GetLastWriteEventError() método para determinar a causa da falha.
- Atributos
Exceções
Se eventPayload contiver muitos objetos ou cadeias de caracteres.
Comentários
O método usa o conjunto de IDs de atividade 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 valor como um ActivityId valor.
Aplica-se a
WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)
Vincula eventos ao rastrear eventos em um 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 -> boolProtected Function WriteTransferEvent (ByRef eventDescriptor As EventDescriptor, relatedActivityId As Guid, dataCount As Integer, data As IntPtr) As BooleanParâmetros
- eventDescriptor
- EventDescriptor
Uma instância desse EventDescriptor tipo identifica o evento a ser gravado.
- relatedActivityId
- Guid
Identificador de atividade do componente anterior. Use esse parâmetro para vincular os eventos do componente aos eventos do componente anterior.
- dataCount
- Int32
Tamanho dos dados de 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 de 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 do evento a serem gravados.
Retornos
É true se o evento for gravado; caso contrário, false. Se for falso, chame o GetLastWriteEventError() método para determinar a causa da falha.
- Atributos
Comentários
O método usa o conjunto de IDs de atividade no contexto do thread para identificar esse componente. Para definir a ID da atividade, chame o SetActivityId método.
