EventSource.WriteEventWithRelatedActivityId(Int32, Guid, Object[]) Método

  • Referência

Definição

Namespace:
System.Diagnostics.Tracing
Assembly:
System.Diagnostics.Tracing.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Origem:
EventSource.cs
Origem:
EventSource.cs
Origem:
EventSource.cs

Grava um evento que indica que a atividade atual está relacionada a outra atividade.

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 relatedActivityId, params object?[] args);
protected void WriteEventWithRelatedActivityId (int eventId, Guid childActivityID, params object[] args);
member this.WriteEventWithRelatedActivityId : int * Guid * obj[] -> unit
member this.WriteEventWithRelatedActivityId : int * Guid * obj[] -> unit
Protected 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())

Parâmetros

eventId
Int32

Um identificador que identifica este evento exclusivamente dentro do EventSource.

relatedActivityIdchildActivityID
Guid

O identificador da atividade relacionada.

args
Object[]

Obtém uma matriz de objetos que contêm dados sobre o evento.

Exemplos

O exemplo de código a seguir mostra como você pode especificar uma fonte de evento que chama 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);
            }
        }
    }

Comentários

O WriteEventWithRelatedActivityId método registra um evento de transferência. A atividade do thread atual é registrada com o evento e isso permite que duas atividades sejam relacionadas por um consumidor de eventos.

Seu método de evento ETW que chama essa função deve seguir estas diretrizes:

  1. Especifique o primeiro parâmetro como um Guid chamado relatedActivityId.

  2. Especifique ou SendReceive como a EventAttribute.Opcode propriedade .

  3. Chame WriteEventWithRelatedActivityId passando a ID do evento, seguido pelo GUID de ID relacionado, seguido por todos os parâmetros que o método de evento é passado, na mesma ordem.

Se args não for usado, ele será convertido em uma matriz vazia para a chamada resultante para ETW.

Aplica-se a