TraceSource.TraceTransfer(Int32, String, Guid) Método
Definição
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.
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);
public void TraceTransfer (int id, 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
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
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.