EventSource.WriteEventWithRelatedActivityIdCore Metode

Definisi

Ruang nama:

System.Diagnostics.Tracing

Rakitan:

netstandard.dll, System.Diagnostics.Tracing.dll

Sumber:

EventSource.cs

Penting

API ini bukan kompatibel CLS.

Menulis peristiwa yang menunjukkan bahwa aktivitas saat ini terkait dengan aktivitas lain.

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

[System.CLSCompliant(false)]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("EventSource will serialize the whole object graph. Trimmer will not safely handle this case because properties may be trimmed. This can be suppressed if the object is a primitive type")]
protected void WriteEventWithRelatedActivityIdCore(int eventId, Guid* relatedActivityId, int eventDataCount, System.Diagnostics.Tracing.EventSource.EventData* data);

[<System.CLSCompliant(false)>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("EventSource will serialize the whole object graph. Trimmer will not safely handle this case because properties may be trimmed. This can be suppressed if the object is a primitive type")>]
member this.WriteEventWithRelatedActivityIdCore : int * nativeptr<Guid> * int * nativeptr<System.Diagnostics.Tracing.EventSource.EventData> -> unit

Parameter

eventId

Int32

Pengidentifikasi yang secara unik mengidentifikasi peristiwa ini dalam EventSource.

relatedActivityId

Guid*

Penunjuk ke GUID ID aktivitas terkait.

eventDataCount

Int32

Jumlah item di data bidang .

data

EventSource.EventData

Penunjuk ke item pertama di bidang data peristiwa.

Atribut

CLSCompliantAttribute RequiresUnreferencedCodeAttribute

Contoh

Contoh kode C# berikut menunjukkan cara menentukan kelebihan metode yang memanggil 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

Keterangan

WriteEventWithRelatedActivityIdCore mirip WriteEventWithRelatedActivityId dengan metode tetapi menawarkan performa yang lebih baik, karena tidak harus membuka kotak childActivityID argumen dan data .

Metode kejadian ETW Anda yang memanggil fungsi ini harus mengikuti panduan berikut:

• Tentukan parameter pertama sebagai Guid bernama relatedActivityId.
• Tentukan salah satu Send atau Receive sebagai EventAttribute.Opcode properti.
• Panggilan WriteEventWithRelatedActivityIdCore yang melewati ID peristiwa, diikuti oleh ID GUID terkait, diikuti oleh semua parameter yang diteruskan oleh metode peristiwa, dalam urutan yang sama.

Metode ini menggunakan aturan yang sama seperti WriteEventCore untuk args parameter . Lihat Dokumentasi WriteEventCore untuk detail selengkapnya.