EventSource.WriteEventWithRelatedActivityIdCore 方法

定義

命名空間:

System.Diagnostics.Tracing

組件:

System.Diagnostics.Tracing.dll

來源:

EventSource.cs

重要

此 API 不符合 CLS 規範。

寫入表示目前活動與另一個活動有關的事件。

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

參數

eventId

Int32

可在 EventSource 中唯一識別這個事件的識別項。

relatedActivityId

Guid*

相關活動識別碼之 GUID 的指標。

eventDataCount

Int32

data 欄位中的項目數。

data

EventSource.EventData

事件資料欄位中第一個項目的指標。

屬性

CLSCompliantAttribute

範例

下列 C# 程式代碼範例示範如何定義呼叫 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

備註

WriteEventWithRelatedActivityIdCore類似於 WriteEventWithRelatedActivityId 方法，但提供較佳的效能，因為它不需要將 和 data 自變數取消收件childActivityID匣。

呼叫此函式的 ETW 事件方法必須遵循下列指導方針：

1. 將第一個 Guid 參數指定為名為 relatedActivityId。

2. Send指定 或 Receive 做為 EventAttribute.Opcode 屬性。

3. 呼叫 WriteEventWithRelatedActivityIdCore 傳入事件標識符，後面接著相關的標識符 GUID，後面接著傳遞事件方法的所有參數，順序相同。

這個方法會使用與 WriteEventCoreargs 參數相同的規則。 如需詳細資訊，請參閱 WriteEventCore 檔。