EventSource.WriteEventWithRelatedActivityIdCore(Int32, Guid*, Int32, EventSource+EventData*) EventSource.WriteEventWithRelatedActivityIdCore(Int32, Guid*, Int32, EventSource+EventData*) EventSource.WriteEventWithRelatedActivityIdCore(Int32, Guid*, Int32, EventSource+EventData*) Method

Définition

Important

Cette API n’est pas conforme CLS.

Écrit un événement qui indique que l'activité actuelle est liée à une autre activité.Writes an event that indicates that the current activity is related to another activity.

protected:
 void WriteEventWithRelatedActivityIdCore(int eventId, Guid* childActivityID, int eventDataCount, System::Diagnostics::Tracing::EventSource::EventData* data);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
protected void WriteEventWithRelatedActivityIdCore (int eventId, Guid* childActivityID, int eventDataCount, System.Diagnostics.Tracing.EventSource.EventData* data);
member this.WriteEventWithRelatedActivityIdCore : int * nativeptr<Guid> * int * nativeptr<System.Diagnostics.Tracing.EventSource.EventData> -> unit

Paramètres

eventId
Int32 Int32 Int32

Identificateur qui identifie de manière unique cet événement au sein de l'objet EventSource.An identifier that uniquely identifies this event within the EventSource.

relatedActivityId
Guid*

Pointeur vers le GUID de l'ID d'activité associé.A pointer to the GUID of the related activity ID.

eventDataCount
Int32 Int32 Int32

Nombre d'éléments dans le champ data.The number of items in the data field.

data
EventSource.EventData*

Pointeur vers le premier élément dans le champ de données de l'événement.A pointer to the first item in the event data field.

Exemples

L’exemple de code c# suivant montre comment définir une surcharge de méthode qui appelle WriteEventWithRelatedActivityIdCore.The following C# code example shows how to define a method overload that calls WriteEventWithRelatedActivityIdCore.

[EventSource(Name = "Litware-ProductName-ComponentName")]
public sealed class LitwareComponentNameEventSource : EventSource
{
    [Event(1, Task = Tasks.Request, Opcode = EventOpcode.Send)]
    public void RequestStart(Guid relatedActivityId, int reqId, string url)
    {
        WriteEventWithRelatedActivityIdCore(1, relatedActivityId, reqId, url);
    }

}

<EventSource(Name:="Litware-ProductName-ComponentName")> _
Public NotInheritable Class LitwareComponentNameEventSource
    Inherits EventSource
    <[Event](1, Task:=Tasks.Request, Opcode:=EventOpcode.Send)> _
    Public Sub RequestStart(relatedActivityId As Guid, reqId As Integer, url As String)
        WriteEventWithRelatedActivityIdCore(1, relatedActivityId, reqId, url)
    End Sub

End Class

#region Keywords / Task / Opcodes
public static class Tasks
{
    public const EventTask Request = (EventTask)0x1;
}
#endregion
#Region "Keywords / Task / Opcodes"
    Public NotInheritable Class Tasks
        Private Sub New()
        End Sub
        Public Const Request As EventTask = DirectCast(&H1, EventTask)
    End Class
#End Region

Remarques

WriteEventWithRelatedActivityIdCore est similaire à la WriteEventWithRelatedActivityId méthode offre mais de meilleures performances, bevcause, il n’a pas d’unboxing le childActivityID et data arguments.WriteEventWithRelatedActivityIdCore is similar to the WriteEventWithRelatedActivityId method but offers better performance, bevcause it does not have to unbox the childActivityID and data arguments.

Votre méthode d’événement ETW appeler cette fonction doit suivre ces recommandations :Your ETW event method calling this function must follow these guidelines:

  1. Spécifier le premier paramètre comme un Guid nommé relatedActivityId.Specify the first parameter as a Guid named relatedActivityId.

  2. Spécifiez soit Send ou Receive comme le EventAttribute.Opcode propriété.Specify either Send or Receive as the EventAttribute.Opcode property.

  3. Appeler WriteEventWithRelatedActivityIdCore en passant dans l’événement ID, suivi par le GUID ID connexes, suivie de tous les paramètres de la méthode d’événement est passé, dans le même ordre.Call WriteEventWithRelatedActivityIdCore passing in the event ID, followed by the related ID GUID, followed by all the parameters the event method is passed, in the same order.

S’applique à