EventProvider.WriteTransferEvent Método

Definición

Espacio de nombres:

System.Diagnostics.Eventing

Ensamblado:

System.Core.dll

Vincula eventos al seguir la traza de eventos en un escenario completo.

Sobrecargas

WriteTransferEvent(EventDescriptor, Guid, Object[])	Vincula eventos al seguir la traza de eventos en un escenario completo. Los datos de evento se especifican como una matriz de objetos.
WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)	Vincula eventos al seguir la traza de eventos en un escenario completo. Los datos del evento se especifican como un bloque de memoria.

WriteTransferEvent(EventDescriptor, Guid, Object[])

Vincula eventos al seguir la traza de eventos en un escenario completo. Los datos de evento se especifican como una 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

Instancia de EventDescriptor que identifica el evento que se va a escribir.

relatedActivityId

Guid

Identificador de actividad del componente anterior. Utilice este parámetro para vincular los eventos del componente con los eventos del componente anterior.

eventPayload

Object[]

Matriz de objetos que contiene los datos del evento que se va a escribir. Los datos deben estar en el orden especificado en el manifiesto. La matriz se limita a 32 objetos, de los que sólo ocho pueden ser cadenas. El tamaño de datos máximo del evento se limita a 64 KB menos el tamaño de los encabezados de evento. El tamaño del evento será menor si el tamaño de búfer de la sesión es menor y la sesión incluye elementos de datos extendidos con el evento.

Devoluciones

Boolean

Es true si se escribe el evento; de lo contrario, es false. Si su valor es false, llame al método GetLastWriteEventError() para determinar la causa del error.

Atributos

SecurityCriticalAttribute

Excepciones

ArgumentException

Si eventPayload contiene demasiados objetos o cadenas.

Comentarios

El método usa el identificador de actividad establecido en el contexto del subproceso para identificar este componente. Para establecer el identificador de actividad, llame al SetActivityId método .

Si usa la Trace clase , no usa el SetActivityId método para especificar el identificador de actividad. En su lugar, acceda a la CorrelationManager propiedad para obtener el CorrelationManager objeto . A continuación, establezca la ActivityId propiedad en el identificador de actividad. También debe establecer en relatedActivityId un ActivityId valor.

WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)

Vincula eventos al seguir la traza de eventos en un escenario completo. Los datos del evento se especifican como un bloque de memoria.

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

Instancia de EventDescriptor que identifica el evento que se va a escribir.

relatedActivityId

Guid

Identificador de actividad del componente anterior. Utilice este parámetro para vincular los eventos del componente con los eventos del componente anterior.

dataCount

Int32

Tamaño de los datos del evento a los que apunta el parámetro data. El tamaño de datos máximo del evento se limita a 64 KB menos el tamaño de los encabezados de evento. El tamaño del evento será menor si el tamaño de búfer de la sesión es menor y la sesión incluye elementos de datos extendidos con el evento.

data

IntPtr

nativeint

Puntero a los datos del evento que se va escribir.

Devoluciones

Boolean

Es true si se escribe el evento; de lo contrario, es false. Si su valor es false, llame al método GetLastWriteEventError() para determinar la causa del error.

Atributos

SecurityCriticalAttribute

Comentarios

El método usa el identificador de actividad establecido en el contexto del subproceso para identificar este componente. Para establecer el identificador de actividad, llame al SetActivityId método .