TraceSource.TraceTransfer(Int32, String, Guid) Metoda

Definicja

Zapisuje komunikat transferu śledzenia do odbiorników śledzenia w Listeners kolekcji przy użyciu określonego identyfikatora liczbowego, komunikatu i powiązanego identyfikatora działania.

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)

Parametry

id
Int32

Identyfikator liczbowy zdarzenia.

message
String

Komunikat śledzenia do zapisania.

relatedActivityId
Guid

Struktura identyfikująca powiązane działanie.

Atrybuty

Uwagi

Metoda TraceTransfer wywołuje metodę TraceTransfer każdego odbiornika śledzenia we właściwości , Listeners aby zapisać informacje śledzenia. Domyślna TraceTransfer metoda w klasie bazowej TraceListener wywołuje metodę TraceListener.TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) , aby przetworzyć wywołanie, ustawiając TraceEventType.Transfer metodę eventType na i dołączając ciąg reprezentujący relatedActivityId identyfikator GUID do messagemetody .

TraceTransfer jest przeznaczony do użycia z operacjami logicznymi obiektu CorrelationManager. Parametr relatedActivityId odnosi się do ActivityId właściwości CorrelationManager obiektu. Jeśli operacja logiczna rozpoczyna się w jednym działaniu i jest przenoszona do innego, drugie działanie rejestruje transfer przez wywołanie TraceTransfer metody . Wywołanie TraceTransfer wiąże nową tożsamość działania z poprzednią tożsamością. Najbardziej prawdopodobnym użytkownikiem tej funkcji jest przeglądarka śledzenia, która może zgłaszać operacje logiczne obejmujące wiele działań.

Dotyczy

Zobacz też