TraceSource.TraceTransfer(Int32, String, Guid) Método

Definição

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.TraceSource.dll

Origem:

TraceSource.cs

Grava uma mensagem de transferência de rastreamento nos ouvintes de rastreamento na coleção Listeners usando o identificador numérico especificado, a mensagem e o identificador de atividade relacionada.

public:
 void TraceTransfer(int id, System::String ^ message, Guid relatedActivityId);

[System.Diagnostics.Conditional("TRACE")]
public void TraceTransfer (int id, string? message, Guid relatedActivityId);

[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceTransfer : int * string * Guid -> unit

Public Sub TraceTransfer (id As Integer, message As String, relatedActivityId As Guid)

Parâmetros

id

Int32

Um identificador numérico do evento.

message

String

A mensagem de rastreamento a ser gravada.

relatedActivityId

Guid

Uma estrutura que identifica a atividade relacionada.

Atributos

ConditionalAttribute

Comentários

O TraceTransfer método chama o TraceTransfer método de cada ouvinte de rastreamento na Listeners propriedade para gravar as informações de rastreamento. O método padrão TraceTransfer na classe base TraceListener chama o TraceListener.TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) método para processar a chamada, definindo eventType como TraceEventType.Transfer e acrescentando uma representação de cadeia de caracteres do relatedActivityId GUID para message.

TraceTransfer destina-se a ser usado com as operações lógicas de um CorrelationManager. O relatedActivityId parâmetro está relacionado à ActivityId propriedade de um CorrelationManager objeto . Se uma operação lógica começar em uma atividade e for transferida para outra, a segunda atividade registrará a transferência chamando o TraceTransfer método . A TraceTransfer chamada relaciona a nova identidade de atividade à identidade anterior. O consumidor mais provável dessa funcionalidade é um visualizador de rastreamento que pode relatar operações lógicas que abrangem várias atividades.

Confira também

• XmlWriterTraceListener
• EventSchemaTraceListener
• DelimitedListTraceListener