TraceSource.TraceTransfer(Int32, String, Guid) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à.