EventSource.WriteEventWithRelatedActivityId(Int32, Guid, Object[]) Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Diagnostics.Tracing

Assembly:: System.Diagnostics.Tracing.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Origine:: EventSource.cs

Origine:: EventSource.cs

Origine:: EventSource.cs

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Scrive un evento che indica che l'attività corrente è correlata a un'altra attività.

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())

Parametri

eventId: Int32

Identificatore che identifica in modo univoco questo evento nell'oggetto EventSource.

relatedActivityIdchildActivityID: Guid

Identificatore dell'attività correlata.

args: Object[]

Matrice di oggetti che contiene i dati relativi all'evento.

Esempio

Nell'esempio di codice seguente viene illustrato come è possibile specificare un'origine evento che chiama 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);
            }
        }
    }

Commenti

Il WriteEventWithRelatedActivityId metodo registra un evento di trasferimento. L'attività del thread corrente viene registrata con l'evento e consente di associare due attività a un consumer di eventi.

Il metodo di evento ETW che chiama questa funzione deve seguire queste linee guida:

Specificare il primo parametro come oggetto Guid denominato relatedActivityId.
Send Specificare o Receive come EventAttribute.Opcode proprietà.
La chiamata WriteEventWithRelatedActivityId passando l'ID evento, seguita dal GUID ID correlato, seguita da tutti i parametri che il metodo evento viene passato, nello stesso ordine.

Se args non viene usato, viene convertito in una matrice vuota per la chiamata risultante a ETW.

Si applica a

Condividi tramite