EventSource.WriteEventWithRelatedActivityIdCore Methode

Definitie

Naamruimte:
System.Diagnostics.Tracing
Assembly's:
mscorlib.dll, System.Diagnostics.Tracing.dll
Assembly:
mscorlib.dll
Assembly:
System.Diagnostics.Tracing.dll
Assembly:
netstandard.dll

Belangrijk

Deze API is niet CLS-conform.

Hiermee schrijft u een gebeurtenis die aangeeft dat de huidige activiteit is gerelateerd aan een andere activiteit.

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)]
[System.Security.SecurityCritical]
protected void WriteEventWithRelatedActivityIdCore(int eventId, Guid* childActivityID, 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>]
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

Parameters

eventId
Int32

Een id die deze gebeurtenis uniek identificeert binnen de EventSource.

relatedActivityIdchildActivityID
Guid*

Een aanwijzer naar de GUID van de gerelateerde activiteits-id.

eventDataCount
Int32

Het aantal items in het data veld.

data
EventSource.EventData

Een aanwijzer naar het eerste item in het veld gebeurtenisgegevens.

Kenmerken
CLSCompliantAttribute SecurityCriticalAttribute

Voorbeelden

In het volgende C#-codevoorbeeld ziet u hoe u een overbelasting van een methode definieert die aanroept 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

Opmerkingen

WriteEventWithRelatedActivityIdCoreis vergelijkbaar met de WriteEventWithRelatedActivityId methode, maar biedt betere prestaties, omdat het postvak niet hoeft uit te schakelen en datachildActivityID argumenten.

De ETW-gebeurtenismethode die deze functie aanroept, moet de volgende richtlijnen volgen:

  • Geef de eerste parameter op als een Guid benoemde relatedActivityId.
  • Geef een van Send de eigenschappen op of Receive als de EventAttribute.Opcode eigenschap.
  • Aanroep WriteEventWithRelatedActivityIdCore die de gebeurtenis-id doorgeeft, gevolgd door de gerelateerde ID-GUID, gevolgd door alle parameters die de gebeurtenismethode wordt doorgegeven, wordt in dezelfde volgorde doorgegeven.

Deze methode gebruikt dezelfde regels als WriteEventCore voor de args parameter. Zie de documentatie voor WriteEventCore voor meer informatie.

Van toepassing op