EventSource.WriteEventWithRelatedActivityIdCore Metoda

Definice

Obor názvů:

System.Diagnostics.Tracing

Sestavení:

netstandard.dll, System.Diagnostics.Tracing.dll

Zdroj:

EventSource.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Zapíše událost, která označuje, že aktuální aktivita souvisí s jinou aktivitou.

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

Parametry

eventId

Int32

Identifikátor, který jednoznačně identifikuje tuto událost v rámci EventSource.

relatedActivityId

Guid*

Ukazatel na identifikátor GUID souvisejícího ID aktivity.

eventDataCount

Int32

Početpoložekch data

data

EventSource.EventData

Ukazatel na první položku v datovém poli události.

Atributy

CLSCompliantAttribute RequiresUnreferencedCodeAttribute

Příklady

Následující příklad kódu jazyka C# ukazuje, jak definovat přetížení metody, které volá 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

Poznámky

WriteEventWithRelatedActivityIdCore je podobná WriteEventWithRelatedActivityId metodě, ale nabízí lepší výkon, protože nemusí rozbalovat childActivityID pole a data argumenty.

Vaše metoda událostí pro Windows, která volá tuto funkci, musí postupovat podle těchto pokynů:

• Zadejte první parametr jako pojmenovaný GuidrelatedActivityId.
• Zadejte buď Send vlastnost, nebo Receive jako EventAttribute.Opcode vlastnost.
• Volání WriteEventWithRelatedActivityIdCore předávající ID události následované identifikátorem GUID souvisejícího ID následované všemi parametry, které metoda události předává, ve stejném pořadí.

Tato metoda používá stejná pravidla jako WriteEventCore pro args parametr. Další podrobnosti najdete v dokumentaci k WriteEventCore.