LoggingChannel Класс

Определение

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

Windows.Foundation.Diagnostics

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

public ref class LoggingChannel sealed : 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.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)

Комментарии

По умолчанию loggingLevel имеет значение Verbose.

Добавьте экземпляры LoggingChannel в LoggingSession или FileLoggingSession , чтобы включить ведение журнала в приложении.

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

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 или другим средствам трассировки и отладки событий. См. также раздел LoggingSession FileLoggingSession ILoggingChannel IClosable Пример ведения журнала (Windows 10)