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

Definición

Espacio de nombres:

System.Diagnostics.Tracing

Ensamblado:

System.Diagnostics.Tracing.dll

Source:

EventSource.cs

Escribe un evento que indica que la actividad actual se relaciona con otra actividad.

protected:
 void WriteEventWithRelatedActivityId(int eventId, Guid relatedActivityId, ... cli::array <System::Object ^> ^ args);

protected void WriteEventWithRelatedActivityId (int eventId, Guid relatedActivityId, params object?[] args);

member this.WriteEventWithRelatedActivityId : int * Guid * obj[] -> unit

Protected Sub WriteEventWithRelatedActivityId (eventId As Integer, relatedActivityId As Guid, ParamArray args As Object())

Parámetros

eventId

Int32

Un identificador que identifica de forma única este evento dentro de EventSource.

relatedActivityId

Guid

Identificador de actividad relacionado.

args

Object[]

Matriz de objetos que contiene los datos del evento.

Ejemplos

En el ejemplo de código siguiente se muestra cómo puede especificar un origen de eventos que llama a 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);
            }
        }
    }

Comentarios

El WriteEventWithRelatedActivityId método registra un evento de transferencia. La actividad del subproceso actual se registra con el evento y esto permite que dos actividades estén relacionadas con un consumidor de eventos.

El método de eventos ETW que llama a esta función debe seguir estas directrices:

1. Especifique el primer parámetro como un Guid denominado relatedActivityId.

2. Especifique o SendReceive como la EventAttribute.Opcode propiedad .

3. Llamada WriteEventWithRelatedActivityId que pasa el identificador de evento, seguido del GUID de identificador relacionado, seguido de todos los parámetros que se pasa el método de evento, en el mismo orden.

Si args no se usa, se convierte en una matriz vacía para la llamada resultante a ETW.