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

Definição

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.

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

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

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.

Aplica-se a

Confira também