EventSource.WriteEventWithRelatedActivityIdCore Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Diagnostics.Tracing

Assembly:: System.Diagnostics.Tracing.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Source:: EventSource.cs

Source:: EventSource.cs

Source:: EventSource.cs

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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);

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* 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)]
[System.Security.SecurityCritical]
protected void WriteEventWithRelatedActivityIdCore (int eventId, Guid* childActivityID, int eventDataCount, System.Diagnostics.Tracing.EventSource.EventData* data);

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

[<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.

relatedActivityIdchildActivityID: 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 SecurityCriticalAttribute

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:

Specificare il primo parametro come oggetto Guid denominato relatedActivityId.
Send Specificare o Receive come EventAttribute.Opcode proprietà.
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.

Si applica a