EventProvider.WriteTransferEvent Méthode

Définition

Lie des événements lors du traçage d'événements dans un scénario de bout en bout.

Surcharges

WriteTransferEvent(EventDescriptor, Guid, Object[])

Lie des événements lors du traçage d'événements dans un scénario de bout en bout. Les données d'événement sont spécifiées comme un tableau d'objets.

WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)

Lie des événements lors du traçage d'événements dans un scénario de bout en bout. Les données de l'événement sont spécifiées comme un bloc de mémoire.

WriteTransferEvent(EventDescriptor, Guid, Object[])

Lie des événements lors du traçage d'événements dans un scénario de bout en bout. Les données d'événement sont spécifiées comme un tableau d'objets.

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

Paramètres

eventDescriptor
EventDescriptor

Instance de EventDescriptor qui identifie l'événement à écrire.

relatedActivityId
Guid

Identificateur d'activité du composant précédent. Utilisez ce paramètre pour lier les événements de votre composant aux événements du composant précédent.

eventPayload
Object[]

Tableau d'objets qui contient les données d'événement à écrire. Les données doivent être dans l'ordre spécifié dans le manifeste. Le tableau est limité à 32 objets, dont huit seulement peuvent être des chaînes. La taille maximale des données pour l'événement est limitée à 64 Ko, moins la taille des en-têtes de l'événement. La taille de l'événement est inférieure si la taille de la mémoire tampon de la session est inférieure et si la session inclut des éléments de données étendus à l'événement.

Retours

A la valeur true si l'événement est écrit ; sinon, false. Si la valeur est « false », appelez la méthode GetLastWriteEventError() pour déterminer la cause de l'échec.

Attributs

Exceptions

Si eventPayload contient trop d'objets ou chaînes.

Remarques

La méthode utilise l’ID d’activité défini dans le contexte de thread pour identifier ce composant. Pour définir l’ID d’activité, appelez la SetActivityId méthode .

Si vous utilisez la Trace classe, vous n’utilisez pas la SetActivityId méthode pour spécifier l’ID d’activité. Au lieu de cela, accédez à la CorrelationManager propriété pour obtenir l’objet CorrelationManager . Ensuite, définissez la propriété sur ActivityId l’ID d’activité. Vous devez également définir sur relatedActivityId une ActivityId valeur.

S’applique à

WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)

Lie des événements lors du traçage d'événements dans un scénario de bout en bout. Les données de l'événement sont spécifiées comme un bloc de mémoire.

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

Paramètres

eventDescriptor
EventDescriptor

Instance de EventDescriptor qui identifie l'événement à écrire.

relatedActivityId
Guid

Identificateur d'activité du composant précédent. Utilisez ce paramètre pour lier les événements de votre composant aux événements du composant précédent.

dataCount
Int32

Taille des données de l'événement sur lesquelles le paramètre data pointe. La taille maximale des données de l'événement est limitée à 64 Ko, moins la taille des en-têtes de l'événement. La taille de l'événement est inférieure si la taille de la mémoire tampon de la session est inférieure et si la session inclut des éléments de données étendus à l'événement.

data
IntPtr

nativeint

Pointeur sur les données de l'événement à écrire.

Retours

A la valeur true si l'événement est écrit ; sinon, false. Si la valeur est « false », appelez la méthode GetLastWriteEventError() pour déterminer la cause de l'échec.

Attributs

Remarques

La méthode utilise l’ID d’activité défini dans le contexte de thread pour identifier ce composant. Pour définir l’ID d’activité, appelez la SetActivityId méthode .

S’applique à