EventSource.WriteEventWithRelatedActivityIdCore Метод

Определение

Пространство имен:

System.Diagnostics.Tracing

Сборки:

netstandard.dll, 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)]
[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

Параметры

eventId

Int32

Идентификатор, который однозначно идентифицирует это событие в пределах EventSource.

relatedActivityId

Guid*

Указатель на GUID связанного идентификатора действия.

eventDataCount

Int32

Количество элементов в data поле.

data

EventSource.EventData

Указатель на первый элемент в поле данных события.

Атрибуты

CLSCompliantAttribute RequiresUnreferencedCodeAttribute

Примеры

В следующем примере кода 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 , но обеспечивает лучшую производительность, так как не требуется распаковка childActivityID аргументов и data аргументов.

Метод событий ETW, вызывающий эту функцию, должен соответствовать следующим рекомендациям:

• Укажите первый параметр как именованный GuidrelatedActivityId.
• Укажите или SendReceive как EventAttribute.Opcode свойство.
• Вызов WriteEventWithRelatedActivityIdCore , передаваемый идентификатором события, а затем соответствующим идентификатором GUID, за которым следует все параметры метода события, передаются в том же порядке.

Этот метод использует те же правила, что WriteEventCore и для args параметра. Дополнительные сведения см. в документации По WriteEventCore.