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 для записи сведений трассировки. Метод по умолчанию в базовом TraceListener классе вызывает TraceListener.TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) метод для обработки вызова, настройки TraceEventType.TransfereventType и добавления строкового relatedActivityId представления GUID в message.TraceTransfer
TraceTransfer предназначен для использования с логическими операциями объекта CorrelationManager. Параметр relatedActivityId относится к ActivityId свойству CorrelationManager объекта. Если логическая операция начинается в одном действии и передается в другую, вторая операция регистрирует передачу TraceTransfer путем вызова метода. Вызов TraceTransfer связывает новое удостоверение действия с предыдущим удостоверением. Наиболее вероятным потребителем этой функции является средство просмотра трассировки, которое может сообщать логические операции, охватывающие несколько действий.