TraceSource.TraceTransfer(Int32, String, Guid) Metodo

Definizione

Scrive un messaggio di traccia di trasferimento nei listener di traccia della raccolta Listeners usando l'identificatore numerico, il messaggio e l'identificatore di attività correlata specificati.

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)

Parametri

id
Int32

Identificatore numerico per l'evento.

message
String

Messaggio di traccia da scrivere.

relatedActivityId
Guid

Struttura che identifica l'attività correlata.

Attributi

Commenti

Il TraceTransfer metodo chiama il TraceTransfer metodo di ogni listener di traccia nella Listeners proprietà per scrivere le informazioni di traccia. Il metodo predefinito TraceTransfer nella classe base TraceListener chiama il TraceListener.TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) metodo per elaborare la chiamata, impostare eventType su TraceEventType.Transfer e accodare una rappresentazione di stringa del relatedActivityId GUID a message.

TraceTransfer deve essere usato con le operazioni logiche di un oggetto CorrelationManager. Il relatedActivityId parametro è correlato alla ActivityId proprietà di un CorrelationManager oggetto . Se un'operazione logica inizia in un'attività e trasferisce a un'altra, la seconda attività registra il trasferimento chiamando il TraceTransfer metodo . La TraceTransfer chiamata mette in relazione la nuova identità dell'attività con l'identità precedente. Il consumer più probabile di questa funzionalità è un visualizzatore di traccia in grado di segnalare operazioni logiche che si estendono su più attività.

Si applica a

Vedi anche