LoggingChannel Класс

Ссылка

Определение

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

Важно!

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

Изменить

Представляет источник сообщений журнала.

public ref class LoggingChannel sealed : IClosable

/// [Windows.Foundation.Metadata.Activatable(Windows.Foundation.Diagnostics.ILoggingChannelFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Foundation.Diagnostics.ILoggingChannelFactory2, 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 LoggingChannel 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.ILoggingChannelFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(Windows.Foundation.Diagnostics.ILoggingChannelFactory2, 65536, "Windows.Foundation.UniversalApiContract")]
class LoggingChannel final : IClosable

[Windows.Foundation.Metadata.Activatable(typeof(Windows.Foundation.Diagnostics.ILoggingChannelFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Foundation.Diagnostics.ILoggingChannelFactory2), 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 LoggingChannel : 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.ILoggingChannelFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Foundation.Diagnostics.ILoggingChannelFactory2), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class LoggingChannel : System.IDisposable

function LoggingChannel(name, options, id)

Public NotInheritable Class LoggingChannel
Implements IDisposable

Наследование: Object Platform::Object IInspectable LoggingChannel

Атрибуты: ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Реализации: IClosable IDisposable ILoggingChannel ILoggingTarget

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Windows 10 Теперь поддерживаются два режима работы: Windows 8.1 режим совместимости и новое поведение, поддерживаемое Windows 10 и более поздних версий, которое позволяет регистрировать события трассировки событий Windows без манифеста. + Для Windows 8.1 режиме совместимости создайте объект с помощью конструктора LoggingChannel(String).

Для конкретного поведения Windows 10 и более поздних версий создайте объект с помощью конструктора LoggingChannel(String, LoggingChannelOptions) или LoggingChannel(String, LoggingChannelOptions, Guid). Различия между этими двумя режимами:

режим совместимости Windows 8.1

Конкретное поведение Windows 10 и более поздних версий

Некоторые события **LoggingChannel** могут ссылаются на 4bd2826e-54a1-4ba9-bf63-92b73ea1ac4a, который является [GUID](/windows/win32/api/guiddef/ns-guiddef-guid) для манифеста **Microsoft-Windows-Diagnostics-LoggingChannel**, доступного Windows 8.1 или более поздней версии.

Все события описываются самостоятельно. Манифест не требуется.

The

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

LoggingChannel(String)	Этот конструктор создает LoggingChannel в режиме совместимости Windows 8.1.
LoggingChannel(String, LoggingChannelOptions)	Инициализирует новый экземпляр класса LoggingChannel с указанными параметрами.
LoggingChannel(String, LoggingChannelOptions, Guid)	Инициализирует новый экземпляр класса LoggingChannel с указанными параметрами и идентификатором канала.

Свойства

Enabled	Возвращает значение, указывающее, регистрируется ли хотя бы один сеанс событий из этого канала.
Id	Возвращает идентификатор поставщика для этого канала.
Level	Возвращает минимальный уровень, на котором любой сеанс прослушивает события из этого канала.
Name	Возвращает имя текущего объекта LoggingChannel.

Методы

Close()	Завершает ведение журнала в текущем канале ведения журнала.
Dispose()	Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов.
IsEnabled()	Указывает, прослушивает ли хотя бы один сеанс события из канала.
IsEnabled(LoggingLevel)	Указывает, прослушивает ли хотя бы один сеанс события с указанным уровнем серьезности событий из канала.
IsEnabled(LoggingLevel, Int64)	Указывает, прослушивает ли хотя бы один сеанс события с указанным уровнем и ключевыми словами из этого канала.
LogEvent(String)	Регистрирует событие с указанным именем.
LogEvent(String, LoggingFields)	Регистрирует событие с указанным именем и полями.
LogEvent(String, LoggingFields, LoggingLevel)	Регистрирует событие с указанным именем, полями и уровнем.
LogEvent(String, LoggingFields, LoggingLevel, LoggingOptions)	Регистрирует событие с указанным именем, полями, уровнем и параметрами.
LogMessage(String)	Записывает сообщение в текущий LoggingChannel.
LogMessage(String, LoggingLevel)	Записывает сообщение в текущий LoggingChannel с указанным LoggingLevel.
LogValuePair(String, Int32)	Записывает данные в текущий LoggingChannel.
LogValuePair(String, Int32, LoggingLevel)	Записывает данные в текущий LoggingChannel с указанным LoggingLevel.
StartActivity(String)	Записывает событие запуска действия и создает объект LoggingActivity .
StartActivity(String, LoggingFields)	Записывает событие запуска действия с указанными полями и создает объект LoggingActivity .
StartActivity(String, LoggingFields, LoggingLevel)	Записывает событие запуска действия с указанными полями и уровнем и создает объект LoggingActivity .
StartActivity(String, LoggingFields, LoggingLevel, LoggingOptions)	Записывает событие запуска действия с указанными полями, уровнем и параметрами и создает объект LoggingActivity .

События

LoggingEnabled

Возникает, когда канал ведения журнала подключен к LoggingSession или другим средствам трассировки и отладки событий.

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

Поделиться через

LoggingChannel Класс

Определение

Требования к Windows

Комментарии

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

Свойства

Методы

События

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

См. также раздел

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

Дополнительные ресурсы