EventSource.WriteEventWithRelatedActivityIdCore 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

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Importante

Esta API não está em conformidade com CLS.

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

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)]
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)>]
[<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

Parâmetros

eventId: Int32

Um identificador que identifica este evento exclusivamente dentro do EventSource.

relatedActivityIdchildActivityID: Guid*

Um ponteiro para o GUID da ID de atividade relacionada.

eventDataCount: Int32

O número de itens no campo data.

data: EventSource.EventData

Um ponteiro para o primeiro item no campo de dados de evento.

Atributos: CLSCompliantAttribute SecurityCriticalAttribute

Exemplos

O exemplo de código C# a seguir mostra como definir uma sobrecarga de método que chama 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

Comentários

WriteEventWithRelatedActivityIdCore é semelhante ao WriteEventWithRelatedActivityId método , mas oferece melhor desempenho, pois não precisa desmarcá-los childActivityIDdata .

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

Especifique o primeiro parâmetro como um Guid chamado relatedActivityId.
Especifique ou Send Receive como a EventAttribute.Opcode propriedade .
Chame WriteEventWithRelatedActivityIdCore passando a ID do evento, seguida pelo GUID de ID relacionado, seguido por todos os parâmetros que o método de evento é passado, na mesma ordem.

Esse método usa as mesmas regras WriteEventCore que para o args parâmetro . Confira a documentação do WriteEventCore para obter mais detalhes.

Aplica-se a

Compartilhar via