EventProvider.WriteTransferEvent Metodo

Definizione

Spazio dei nomi:

System.Diagnostics.Eventing

Assembly:

System.Core.dll

Collega eventi in caso di tracciatura di eventi in uno scenario end-to-end.

Overload

WriteTransferEvent(EventDescriptor, Guid, Object[])	Collega eventi in caso di tracciatura di eventi in uno scenario end-to-end. I dati dell'evento sono specificati come matrice di oggetti.
WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)	Collega eventi in caso di tracciatura di eventi in uno scenario end-to-end. I dati dell'evento vengono specificati come blocco di memoria.

WriteTransferEvent(EventDescriptor, Guid, Object[])

Collega eventi in caso di tracciatura di eventi in uno scenario end-to-end. I dati dell'evento sono specificati come matrice di oggetti.

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

Parametri

eventDescriptor

EventDescriptor

Istanza di EventDescriptor che identifica l'evento da scrivere.

relatedActivityId

Guid

Identificatore di attività del componente precedente. Utilizzare questo parametro per collegare gli eventi del componente agli eventi del componente precedente.

eventPayload

Object[]

Matrice di oggetti che contiene i dati dell'evento da scrivere. I dati devono essere nell'ordine specificato nel manifesto. La matrice è limitata a 32 oggetti dei quali solo otto possono essere stringhe. La dimensione massima dei dati per l'evento è limitata a 64 KB esclusa la dimensione delle intestazioni dell'evento. Se la sessione ha una dimensione del buffer ridotta e include elementi di dati estesi con l'evento, la dimensione dell'evento sarà ridotta.

Restituisce

Boolean

true se l'evento viene scritto, in caso contrario false. Se è false, chiamare il metodo GetLastWriteEventError() per determinare la causa dell'errore.

Attributi

SecurityCriticalAttribute

Eccezioni

ArgumentException

Se eventPayload contiene un numero eccessivo di oggetti o stringhe.

Commenti

Il metodo usa l'ID attività impostato nel contesto del thread per identificare questo componente. Per impostare l'ID attività, chiamare il SetActivityId metodo .

Se si usa la Trace classe , non si usa il SetActivityId metodo per specificare l'ID attività. Accedere invece alla CorrelationManager proprietà per ottenere l'oggetto CorrelationManager . Impostare quindi la ActivityId proprietà sull'ID attività. È inoltre necessario impostare su relatedActivityId un ActivityId valore .

WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)

Collega eventi in caso di tracciatura di eventi in uno scenario end-to-end. I dati dell'evento vengono specificati come blocco di 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

Parametri

eventDescriptor

EventDescriptor

Istanza di EventDescriptor che identifica l'evento da scrivere.

relatedActivityId

Guid

Identificatore di attività del componente precedente. Utilizzare questo parametro per collegare gli eventi del componente agli eventi del componente precedente.

dataCount

Int32

Dimensione dei dati dell'evento a cui punta il parametro data. La dimensione massima dei dati dell'evento è limitata a 64 KB esclusa la dimensione delle intestazioni dell'evento. Se la sessione ha una dimensione del buffer ridotta e include elementi di dati estesi con l'evento, la dimensione dell'evento sarà ridotta.

data

IntPtr

nativeint

Puntatore ai dati dell'evento da scrivere.

Restituisce

Boolean

true se l'evento viene scritto, in caso contrario false. Se è false, chiamare il metodo GetLastWriteEventError() per determinare la causa dell'errore.

Attributi

SecurityCriticalAttribute

Commenti

Il metodo usa l'ID attività impostato nel contesto del thread per identificare questo componente. Per impostare l'ID attività, chiamare il SetActivityId metodo .