TraceSource.TraceTransfer(Int32, String, Guid) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Записывает сообщение о перемещении трассировки в прослушиватели трассировки коллекции Listeners, используя для этого указанный числовой идентификатор, сообщение, а также идентификатор сопутствующего действия.
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)
Параметры
- id
- Int32
Числовой идентификатор события.
- message
- String
Записываемое сообщение трассировки.
- relatedActivityId
- Guid
Структура, идентифицирующая сопутствующее действие.
- Атрибуты
Комментарии
Метод TraceTransfer вызывает TraceTransfer метод каждого прослушивателя трассировки в свойстве Listeners для записи сведений трассировки. Метод по умолчанию TraceTransfer в базовом TraceListener классе вызывает TraceListener.TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) метод для обработки вызова , задав значение eventType
TraceEventType.Transfer и добавив строковое представление GUID message
в relatedActivityId
.
TraceTransfer предназначен для использования с логическими операциями CorrelationManager. Параметр relatedActivityId
относится к свойству ActivityIdCorrelationManager объекта . Если логическая операция начинается в одном действии и передается другому, второе действие регистрирует передачу путем вызова TraceTransfer метода . Вызов TraceTransfer связывает новое удостоверение действия с предыдущим удостоверением. Наиболее вероятным потребителем этой функции является средство просмотра трассировки, которое может сообщать о логических операциях, охватывающих несколько действий.