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

Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

Confira também