XmlWriterTraceListener.TraceTransfer(TraceEventCache, String, Int32, String, Guid) Metodo

Definizione

Scrive informazioni di traccia, compresi l'identità di un'attività correlata, un messaggio e informazioni di evento, nel file o nel flusso.Writes trace information including the identity of a related activity, a message, and event information to the file or stream.

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)

Parametri

eventCache
TraceEventCache

Oggetto TraceEventCache contenente l'ID processo corrente, l'ID thread e le informazioni di traccia dello stack.A TraceEventCache that contains the current process ID, thread ID, and stack trace information.

source
String

Nome di origine.The source name.

id
Int32

Identificatore numerico per l'evento.A numeric identifier for the event.

message
String

Messaggio di traccia da scrivere.A trace message to write.

relatedActivityId
Guid

Struttura Guid che identifica un'attività correlata.A Guid structure that identifies a related activity.

Commenti

Il metodo TraceTransfer viene utilizzato per la correlazione delle tracce correlate.The TraceTransfer method is used for the correlation of related traces. I parametri eventCache, source, ide relatedActivityId vengono utilizzati nell'intestazione e nel piè di pagina della traccia.The eventCache, source, id, and relatedActivityId parameters are used in the header and footer of the trace. Il id parametro viene convertito in un Unsigned Integer prima della scrittura, quindi un valore di id negativo viene scritto come un numero intero positivo grande.The id parameter is converted to an unsigned integer before writing, so a negative id value is written as a large positive integer. Il parametro message viene scritto come elemento Message.The message parameter is written as the Message element. Viene chiamato il metodo Guid.ToString(String) per convertire il valore relatedActivityIdin una stringa formattata "B", che viene visualizzata nell'intestazione.The Guid.ToString(String) method is called to convert the relatedActivityIdvalue to a "B" formatted string, which appears in the header. L'elemento SubTypeName nel piè di pagina identifica il tipo di evento di traccia come Transfer.The SubTypeName element in the footer identifies the trace event type as a Transfer.

Importante

Il metodo TraceTransfer non è destinato a essere chiamato dal codice dell'applicazione.The TraceTransfer method is not intended to be called by application code. Deve essere chiamato da un oggetto TraceSource per emettere le informazioni di traccia per il relativo metodo TraceTransfer.It is intended to be called by a TraceSource object to emit the trace information for its TraceTransfer method.

Sicurezza

SecurityPermission
per la possibilità di chiamare codice non gestito.for the ability to call unmanaged code. Enumerazione associata: UnmanagedCode.Associated enumeration: UnmanagedCode.

Si applica a