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 para os ouvintes de rastreamento na Listeners coleção usando o identificador numérico, a mensagem e o identificador de atividade relacionado especificados.
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 -> unitmember this.TraceTransfer : int * string * Guid -> unitPublic Sub TraceTransfer (id As Integer, message As String, relatedActivityId As Guid)Parâmetros
- id
- Int32
Um identificador numérico para o 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 TraceEventType.TransfereventType e acrescentando uma representação de cadeia de caracteres do relatedActivityId GUID a 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 em log 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.
