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

Definição

Escreve uma mensagem de transferência de traço para os ouvintes de traços na Listeners coleção usando o identificador numérico especificado, mensagem e identificador de atividade relacionado.

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 para o evento.

message
String

A mensagem de rastreamento a escrever.

relatedActivityId
Guid

Uma estrutura que identifica a atividade relacionada.

Atributos

Observações

O TraceTransfer método chama o TraceTransfer método de cada ouvinte de traço na Listeners propriedade para escrever a informação do traço. 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 para TraceEventType.Transfer e adicionando uma representação de string do relatedActivityId GUID a message.

TraceTransfer é destinado a ser usado com as operações lógicas de um CorrelationManager. O relatedActivityId parâmetro relaciona-se com a ActivityId propriedade de um CorrelationManager objeto. Se uma operação lógica começar numa atividade e transferir para outra, a segunda atividade regista a transferência chamando o TraceTransfer método. A TraceTransfer chamada relaciona a nova identidade da atividade com a identidade anterior. O consumidor mais provável desta funcionalidade é um visualizador de traços que pode reportar operações lógicas que abrangem múltiplas atividades.

Aplica-se a

Ver também