XmlWriterTraceListener.TraceTransfer Método

Definição

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.TextWriterTraceListener.dll

Origem:

XmlWriterTraceListener.cs

Grava informações de rastreamento, incluindo a identidade de uma atividade relacionada, uma mensagem e informações de evento no arquivo ou no fluxo.

public:
 override void TraceTransfer(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, int id, System::String ^ message, Guid relatedActivityId);

public override void TraceTransfer (System.Diagnostics.TraceEventCache? eventCache, string source, int id, string? message, Guid relatedActivityId);

override this.TraceTransfer : System.Diagnostics.TraceEventCache * string * int * string * Guid -> unit

Public Overrides Sub TraceTransfer (eventCache As TraceEventCache, source As String, id As Integer, message As String, relatedActivityId As Guid)

Parâmetros

eventCache

TraceEventCache

Um TraceEventCache que contém as informações atuais de ID de processo, ID de thread e rastreamento de pilha.

source

String

O nome da origem.

id

Int32

Um identificador numérico do evento.

message

String

Uma mensagem de rastreamento a ser gravada.

relatedActivityId

Guid

Uma estrutura Guid que identifica uma atividade relacionada.

Comentários

O TraceTransfer método é usado para a correlação de rastreamentos relacionados. Os eventCacheparâmetros , source, ide relatedActivityId são usados no cabeçalho e no rodapé do rastreamento. O id parâmetro é convertido em um inteiro sem sinal antes da gravação, portanto, um valor negativo id é gravado como um inteiro positivo grande. O message parâmetro é gravado como o Message elemento . O Guid.ToString(String) método é chamado para converter o relatedActivityIdvalor em uma cadeia de caracteres formatada "B", que aparece no cabeçalho. O SubTypeName elemento no rodapé identifica o tipo de evento de rastreamento como um Transfer.

Importante

O TraceTransfer método não se destina a ser chamado pelo código do aplicativo. Destina-se a ser chamado por um TraceSource objeto para emitir as informações de rastreamento para seu TraceTransfer método.