Activity Класс

Определение

Пространство имен:: System.Diagnostics

Сборка:: System.Diagnostics.DiagnosticSource.dll

Пакет:: System.Diagnostics.DiagnosticSource v11.0.0-preview.4.26230.115

Исходный код:: Activity.cs

Исходный код:: Activity.cs

Исходный код:: Activity.cs

Исходный код:: Activity.cs

Исходный код:: Activity.cs

Исходный код:: Activity.cs

Исходный код:: Activity.cs

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Представляет операцию и связанный с ней контекст, используемые для журналирования.

public ref class Activity : IDisposable

public ref class Activity

public class Activity : IDisposable

public class Activity

type Activity = class
    interface IDisposable

type Activity = class

Public Class Activity
Implements IDisposable

Public Class Activity

Наследование: Object
Activity

Реализации: IDisposable

Действия должны создаваться путем вызова конструктора, настройки по мере необходимости, а затем запускаются с Start методом, который поддерживает связи родительско-дочерних элементов для действий и наборов Activity.Current.

По завершении действия его следует остановить с Activity.Stop() помощью метода.

Однако при удалении Activity объекта, который останавливает его, поэтому не нужно явно вызывать Activity.Stop(). Это упрощает шаблон кодирования. Дополнительные сведения см. в методе Dispose.

Никакие методы не Activity позволяют исключениям экранировать в качестве ответа на недопустимые входные данные. Они создаются и перехватываются (что позволяет отладчикам и мониторам видеть ошибку), но исключение подавляется, и операция делает что-то разумное (обычно это не делает ничего).

Конструкторы

Имя	Описание
Activity(String)	Инициализирует новый экземпляр класса Activity.

Свойства

Имя	Описание
ActivityTraceFlags	Возвращает или задает флаги (определенные спецификацией идентификатора W3C), связанные с действием.
Baggage	Возвращает коллекцию пар "ключ-значение", представляющих сведения, передаваемые дочерним элементам этого Activityобъекта.
Context	Возвращает контекст действия. Контекст становится допустимым только в том случае, если действие запущено.
Current	Возвращает или задает текущую операцию (Activity) для текущего потока. Это выполняется через асинхронные вызовы.
DefaultIdFormat	Возвращает или задает формат идентификатора Activityпо умолчанию для параметра .
DisplayName	Возвращает или задает отображаемое имя действия.
Duration	Возвращает длительность операции.
Events	Возвращает список всех событий действий, присоединенных к этому действию.
ForceDefaultIdFormat	Возвращает или задает значение, которое детрминирует, если DefaultIdFormat всегда используется для определения формата идентификатора по умолчанию.
HasRandomizedTraceId	Представляет операцию и связанный с ней контекст, используемые для журналирования.
HasRemoteParent	Возвращает значение, указывающее, был ли родительский контекст создан из удаленного распространения.
Id	Возвращает идентификатор, относящееся к конкретному запросу.
IdFormat	Возвращает формат для Idпараметра .
IsAllDataRequested	Возвращает или задает значение, указывающее, должно ли это действие заполняться всеми сведениями о распространении, а также всеми другими свойствами, такими как ссылки, теги и события.
IsStopped	Возвращает значение, указывающее, остановлен ли этот Activity объект.
Kind	Получает связь между действием, его родителями и дочерними элементами в трассировке.
Links	Возвращает список всех ссылок действий, подключенных к этому действию.
OperationName	Возвращает имя операции.
Parent	Возвращает родительский объект Activity , созданный этим действием.
ParentId	Возвращает идентификатор родительского действия.
ParentSpanId	Возвращает родительский SpanIdобъект.
Recorded	Возвращает значение, указывающее, задан ли флаг W3CIdFlags.Recorded.
RootId	Возвращает корневой идентификатор этого Activityобъекта.
Source	Возвращает источник действия, связанный с этим действием.
SpanId	Возвращает часть SPAN элемента Id.
StartTimeUtc	Возвращает время начала операции.
Status	Возвращает код состояния текущего объекта действия.
StatusDescription	Возвращает описание состояния текущего объекта действия.
TagObjects	Возвращает список тегов, представляющих сведения для регистрации вместе с действием. Эти сведения не передаются дочерним элементам этого действия.
Tags	Возвращает коллекцию пар "ключ-значение", представляющих сведения, которые будут регистрироваться вместе с Activity системой ведения журнала.
TraceId	Возвращает часть TraceId элемента Id.
TraceIdGenerator	При запуске действия, в котором нет родительского контекста, идентификатор трассировки автоматически создается с помощью случайных чисел. TraceIdGenerator можно использовать для переопределения алгоритма создания идентификатора трассировки по умолчанию среды выполнения.
TraceStateString	Возвращает или задает заголовок W3C `tracestate` .

Методы

Имя	Описание
AddBaggage(String, String)	Activity Обновляет новый элемент багажа с указанным ключом и значением.
AddEvent(ActivityEvent)	Добавляет указанное событие действия в список событий.
AddException(Exception, TagList, DateTimeOffset)	ActivityEvent Добавьте объект, содержащий сведения об исключении в Events список.
AddLink(ActivityLink)	Добавляется ActivityLink в Links список.
AddTag(String, Object)	Обновляет действие, чтобы иметь тег с дополнительным `key` и `value`.
AddTag(String, String)	Activity Обновляет новый тег с предоставленным `key` и`value`.
Dispose()	Останавливает действие, если оно уже запущено и уведомляет прослушиватели событий. Ничего не произойдет в противном случае.
Dispose(Boolean)	При переопределении производным типом этот метод освобождает все выделенные ресурсы.
EnumerateEvents()	Перечисляет объекты, присоединенные ActivityEvent к этому объекту Activity.
EnumerateLinks()	Перечисляет объекты, присоединенные ActivityLink к этому объекту Activity.
EnumerateTagObjects()	Перечисляет теги, присоединенные к этому объекту Activity.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetBaggageItem(String)	Возвращает значение пары "ключ-значение", добавленной в действие.AddBaggage(String, String)
GetCustomProperty(String)	Возвращает объект, сопоставленный с указанным именем свойства.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetTagItem(String)	Возвращает значение тега действия, сопоставленного с входным ключом. Возвращает, `null` если этот ключ не существует.
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
SetBaggage(String, String)	Добавьте или обновите багаж действия с помощью входного ключа и значения. Если входное значение равно `null` - если коллекция имеет какой-либо багаж с тем же ключом, то этот багаж будет удален из коллекции. — в противном случае ничего не произойдет, и коллекция не изменится. Если входное значение не `null` является - если коллекция имеет багаж с тем же ключом, то значение, сопоставленное с этим ключом, будет обновлено с новым входным значением. — в противном случае ключ и значение будут добавлены в коллекцию в качестве нового багажа. Элемент багажа будет обновлен или удален только в том случае, если он был первоначально добавлен в текущее действие. Элементы, унаследованные от родителей, не будут изменены или удалены, новый элемент будет добавлен в текущий багаж действий.
SetCustomProperty(String, Object)	Присоединяет любой пользовательский объект к этому действию. Если указанный `propertyName` ранее связан с другим объектом, свойство будет обновлено, чтобы оно было связано с новым `propertyValue` объектом. Рекомендуется использовать уникальное имя свойства, чтобы избежать конфликтов с любым пользователем, использующим одно и то же значение.
SetEndTime(DateTime)	Activity Обновляет значение, указывая его Duration в качестве разницы между StartTimeUtc заданным временем остановки.
SetIdFormat(ActivityIdFormat)	Задает формат идентификатора перед Activity началом работы.
SetParentId(ActivityTraceId, ActivitySpanId, ActivityTraceFlags)	Задает родительский идентификатор с помощью соглашения W3C traceId и SpanId.
SetParentId(String)	Обновляет это Activity , чтобы указать, что Activity идентификатор `parentId` причинил это Activity.
SetStartTime(DateTime)	Задает время начала этого Activityпараметра.
SetStatus(ActivityStatusCode, String)	Задает код состояния и описание текущего объекта действия.
SetTag(String, Object)	Добавляет или обновляет тег действия с помощью входного ключа и значения.
Start()	Запускает действие.
Stop()	Останавливает действие.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

События

Имя	Описание
CurrentChanged	Происходит при Current изменении значения.

Применяется к

Обратная связь

Были ли сведения на этой странице полезными?