EventSource.WriteEventWithRelatedActivityIdCore Metodo

Definizione

Spazio dei nomi:

System.Diagnostics.Tracing

Assembly:

System.Diagnostics.Tracing.dll

Source:

EventSource.cs

Importante

Questa API non è conforme a CLS.

Scrive un evento che indica che l'attività corrente è correlata a un'altra attività.

protected:
 void WriteEventWithRelatedActivityIdCore(int eventId, Guid* relatedActivityId, int eventDataCount, System::Diagnostics::Tracing::EventSource::EventData* data);

[System.CLSCompliant(false)]
protected void WriteEventWithRelatedActivityIdCore (int eventId, Guid* relatedActivityId, int eventDataCount, System.Diagnostics.Tracing.EventSource.EventData* data);

[<System.CLSCompliant(false)>]
member this.WriteEventWithRelatedActivityIdCore : int * nativeptr<Guid> * int * nativeptr<System.Diagnostics.Tracing.EventSource.EventData> -> unit

Parametri

eventId

Int32

Identificatore che identifica in modo univoco questo evento nell'oggetto EventSource.

relatedActivityId

Guid*

Puntatore al GUID dell'ID attività correlato.

eventDataCount

Int32

Numero di elementi presenti nel campo data.

data

EventSource.EventData

Puntatore al primo elemento nel campo dati evento.

Attributi

CLSCompliantAttribute

Esempio

Nell'esempio di codice C# seguente viene illustrato come definire un overload di metodo che chiama 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

Commenti

WriteEventWithRelatedActivityIdCore è simile al WriteEventWithRelatedActivityId metodo, ma offre prestazioni migliori, perché non deve annullare la posta in arrivo e childActivityIDdata gli argomenti.

Il metodo di evento ETW che chiama questa funzione deve seguire queste linee guida:

1. Specificare il primo parametro come oggetto Guid denominato relatedActivityId.

2. Send Specificare o Receive come EventAttribute.Opcode proprietà.

3. La chiamata WriteEventWithRelatedActivityIdCore passando l'ID evento, seguita dal GUID ID correlato, seguita da tutti i parametri che il metodo evento viene passato, nello stesso ordine.

Questo metodo usa le stesse regole del WriteEventCoreargs parametro. Per altre informazioni, vedere La documentazione writeEventCore.