LoggingActivity Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает события трассировки событий Windows (ETW), которые помечают начало и конец группы связанных событий.
public ref class LoggingActivity sealed : IClosable/// [Windows.Foundation.Metadata.Activatable(Windows.Foundation.Diagnostics.ILoggingActivityFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class LoggingActivity final : IClosable/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Foundation.Diagnostics.ILoggingActivityFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class LoggingActivity final : IClosable[Windows.Foundation.Metadata.Activatable(typeof(Windows.Foundation.Diagnostics.ILoggingActivityFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class LoggingActivity : System.IDisposable[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Foundation.Diagnostics.ILoggingActivityFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class LoggingActivity : System.IDisposablefunction LoggingActivity(activityName, loggingChannel, level)Public NotInheritable Class LoggingActivity
Implements IDisposable- Наследование
- Атрибуты
- Реализации
Требования к Windows
| Требования | Описание |
|---|---|
| Семейство устройств |
Windows 10 (появилось в 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (появилось в v1.0)
|
Комментарии
Windows 10 Класс LoggingActivity был расширен следующим образом: + Теперь реализует ILoggingTarget , который предоставляет методы запуска и остановки действий, которые обеспечивают управление форматом и содержимым событий Start и Stop.
- Теперь реализует методы для ведения журнала событий. События автоматически помечаются идентификатором GUID LoggingActivity.
- Действия могут быть вложенными. Каждый объект LoggingActivity присоединяется к объекту LoggingChannel . Все события, созданные объектом LoggingActivity , записываются через присоединенный объект LoggingChannel .
Конструкторы
| Имя | Описание |
|---|---|
| LoggingActivity(String, ILoggingChannel) |
Инициализирует новый экземпляр класса LoggingActivity для указанного LoggingChannel в режиме совместимости Windows 8.1. |
| LoggingActivity(String, ILoggingChannel, LoggingLevel) |
Инициализирует новый экземпляр класса LoggingActivity для указанных LoggingChannel и LoggingLevel в режиме совместимости Windows 8.1. |
Свойства
| Имя | Описание |
|---|---|
| Channel |
Возвращает канал, связанный с этим действием. |
| Id |
Возвращает идентификатор текущего действия ведения журнала. |
| Name |
Возвращает имя текущего действия ведения журнала. |
Методы
| Имя | Описание |
|---|---|
| Close() |
Завершает текущее действие ведения журнала. |
| Dispose() |
Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов. |
| IsEnabled() |
Указывает, прослушивается ли хотя бы один сеанс событий из канала, связанного с этим действием. |
| IsEnabled(LoggingLevel) |
Указывает, прослушивается ли хотя бы один сеанс событий с указанным уровнем серьезности события из канала, связанного с этим действием. |
| IsEnabled(LoggingLevel, Int64) |
Указывает, прослушивается ли хотя бы один сеанс событий с указанным уровнем и ключевыми словами из канала, связанного с этим действием. |
| LogEvent(String) |
Регистрирует событие с указанным именем. |
| LogEvent(String, LoggingFields) |
Регистрирует событие с указанным именем и полями. |
| LogEvent(String, LoggingFields, LoggingLevel) |
Регистрирует событие с указанным именем, полями и уровнем. |
| LogEvent(String, LoggingFields, LoggingLevel, LoggingOptions) |
Регистрирует событие с указанным именем, полями, уровнем и параметрами. |
| StartActivity(String) |
Записывает событие запуска действия и создает объект LoggingActivity . |
| StartActivity(String, LoggingFields) |
Записывает событие начала действия с полями и создает объект LoggingActivity . |
| StartActivity(String, LoggingFields, LoggingLevel) |
Записывает событие запуска действия с указанными полями и уровнем и создает объект LoggingActivity . |
| StartActivity(String, LoggingFields, LoggingLevel, LoggingOptions) |
Записывает событие запуска действия с указанными полями, уровнем и параметрами и создает объект LoggingActivity . |
| StopActivity(String) |
Помечает действие как закрытое или удаленное и создает событие остановки с указанным именем события. |
| StopActivity(String, LoggingFields) |
Помечает действие как закрытое или удаленное и создает событие остановки с указанным именем события и полями. |
| StopActivity(String, LoggingFields, LoggingOptions) |
Помечает действие как закрытое или удаленное и создает событие остановки с указанным именем события, полями и параметрами. |