EventSource.WriteEventWithRelatedActivityId(Int32, Guid, Object[]) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Skriver en händelse som anger att den aktuella aktiviteten är relaterad till en annan aktivitet.
protected:
void WriteEventWithRelatedActivityId(int eventId, Guid relatedActivityId, ... cli::array <System::Object ^> ^ args);protected:
void WriteEventWithRelatedActivityId(int eventId, Guid childActivityID, ... cli::array <System::Object ^> ^ args);protected void WriteEventWithRelatedActivityId(int eventId, Guid relatedActivityId, params object[] args);protected void WriteEventWithRelatedActivityId(int eventId, Guid childActivityID, params object[] args);member this.WriteEventWithRelatedActivityId : int * Guid * obj[] -> unitmember this.WriteEventWithRelatedActivityId : int * Guid * obj[] -> unitProtected Sub WriteEventWithRelatedActivityId (eventId As Integer, relatedActivityId As Guid, ParamArray args As Object())Protected Sub WriteEventWithRelatedActivityId (eventId As Integer, childActivityID As Guid, ParamArray args As Object())Parametrar
- eventId
- Int32
En identifierare som unikt identifierar den här händelsen i EventSource.
- relatedActivityIdchildActivityID
- Guid
Den relaterade aktivitetsidentifieraren.
- args
- Object[]
En matris med objekt som innehåller data om händelsen.
Exempel
I följande kodexempel visas hur du kan ange en händelsekälla som anropar WriteEventWithRelatedActivityId.
[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)
{
WriteEventWithRelatedActivityId(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)
WriteEventWithRelatedActivityId(1, relatedActivityId, reqId, url)
End Sub
End Class
[EventSource(Name = "Contoso-ProductName-ComponentName")]
public sealed class CustomizedForPerfEventSource : EventSource
{
[Event(1, Task = Tasks.Request, Opcode = EventOpcode.Send)]
public void RequestStart(Guid relatedActivityId, int reqId, string url)
{
if (IsEnabled())
WriteEventWithRelatedActivityId(1, relatedActivityId, reqId, url);
}
[NonEvent]
unsafe protected void WriteEventWithRelatedActivityId(int eventId, Guid relatedActivityId,
int arg1, string arg2)
{
if (IsEnabled())
{
if (arg2 == null) arg2 = string.Empty;
fixed (char* stringBytes = arg2)
{
EventData* descrs = stackalloc EventData[2];
descrs[0].DataPointer = (IntPtr)(&arg1);
descrs[0].Size = 4;
descrs[1].DataPointer = (IntPtr)stringBytes;
descrs[1].Size = ((arg2.Length + 1) * 2);
WriteEventWithRelatedActivityIdCore(eventId,
&relatedActivityId, 2, descrs);
}
}
}
Kommentarer
Metoden WriteEventWithRelatedActivityId loggar en överföringshändelse. Aktiviteten i den aktuella tråden loggas med händelsen, vilket gör att två aktiviteter kan relateras av en händelsekonsument.
Din ETW-händelsemetod som anropar den här funktionen måste följa dessa riktlinjer:
- Ange den första parametern som med Guid namnet
relatedActivityId. - Ange antingen Send eller Receive som EventAttribute.Opcode egenskap.
- Anropsöverföring WriteEventWithRelatedActivityId i händelse-ID, följt av det relaterade ID GUID, följt av alla parametrar som händelsemetoden skickas i samma ordning.
Om args den inte används konverteras den till en tom matris för det resulterande anropet till ETW.