LoggingChannel Clase

Definición

Espacio de nombres:

Windows.Foundation.Diagnostics

Representa un origen de mensajes de registro.

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

Herencia

Object Platform::Object IInspectable LoggingChannel

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementaciones

IClosable IDisposable ILoggingChannel ILoggingTarget

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

El valor predeterminado de LoggingLevel es Detallado.

Agregue instancias de LoggingChannel a LoggingSession o FileLoggingSession para habilitar el registro en la aplicación.

Los métodos LogMessage proporcionan maneras de registrar mensajes de cadena simples, mientras que los métodos LogEvent proporcionan formas de registrar datos de seguimiento más complejos.

Windows 10 Ahora se admiten dos modos de operación: Windows 8.1 modo de compatibilidad y el nuevo comportamiento admitido por Windows 10 y versiones posteriores, lo que permite registrar eventos de seguimiento de eventos autodescriptivo para Windows (ETW) sin un manifiesto. + Para Windows 8.1 modo de compatibilidad, cree el objeto mediante el constructor LoggingChannel(String).

• Para el comportamiento específico de Windows 10 y versiones posteriores, cree el objeto mediante el constructor LoggingChannel(String, LoggingChannelOptions) o LoggingChannel(String, LoggingChannelOptions, Guid). Las diferencias entre estos dos modos son:

modo de compatibilidad de Windows 8.1	Comportamiento específico de Windows 10 y versiones posteriores
Algunos eventos **LoggingChannel** pueden hacer referencia al 4bd2826e-54a1-4ba9-bf63-92b73ea1ac4a, que es el manifiesto [GUID](/windows/win32/api/guiddef/ns-guiddef-guid) para el manifiesto **Microsoft-Windows-Diagnostics-LoggingChannel** que está disponible en Windows 8.1 o posterior.	Todos los eventos se describen automáticamente. No se requiere ningún manifiesto.
The Constructores LoggingChannel(String) Este constructor crea un LoggingChannel en Windows 8.1 modo de compatibilidad. LoggingChannel(String, LoggingChannelOptions) Inicializa una nueva instancia de la clase LoggingChannel con las opciones especificadas. LoggingChannel(String, LoggingChannelOptions, Guid) Inicializa una nueva instancia de la clase LoggingChannel con las opciones y el identificador de canal especificados. Propiedades Enabled Obtiene un valor que indica si al menos una sesión registra eventos de este canal. Id Devuelve el identificador de proveedor de este canal. Level Obtiene el nivel mínimo en el que cualquier sesión escucha eventos de este canal. Name Obtiene el nombre del objeto LoggingChannel actual. Métodos Close() Finaliza el registro en el canal de registro actual. Dispose() Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados. IsEnabled() Indica si al menos una sesión está escuchando eventos desde el canal. IsEnabled(LoggingLevel) Indica si al menos una sesión está escuchando eventos con el nivel de gravedad de evento especificado desde el canal. IsEnabled(LoggingLevel, Int64) Indica si al menos una sesión está escuchando eventos con el nivel y las palabras clave especificados de este canal. LogEvent(String) Registra un evento con el nombre especificado. LogEvent(String, LoggingFields) Registra un evento con el nombre y los campos especificados. LogEvent(String, LoggingFields, LoggingLevel) Registra un evento con el nombre, los campos y el nivel especificados. LogEvent(String, LoggingFields, LoggingLevel, LoggingOptions) Registra un evento con el nombre, los campos, el nivel y las opciones especificados. LogMessage(String) Registra un mensaje en el canal de registro actual. LogMessage(String, LoggingLevel) Registra un mensaje en el LoggingChannel actual con el LoggingLevel especificado. LogValuePair(String, Int32) Registra los datos en el canal de registro actual. LogValuePair(String, Int32, LoggingLevel) Registra los datos en el LoggingChannel actual con el LoggingLevel especificado. StartActivity(String) Escribe un evento de inicio de actividad y crea un objeto LoggingActivity . StartActivity(String, LoggingFields) Escribe un evento de inicio de actividad con los campos especificados y crea un objeto LoggingActivity . StartActivity(String, LoggingFields, LoggingLevel) Escribe un evento de inicio de actividad con los campos y el nivel especificados y crea un objeto LoggingActivity . StartActivity(String, LoggingFields, LoggingLevel, LoggingOptions) Escribe un evento de inicio de actividad con los campos, el nivel y las opciones especificados, y crea un objeto LoggingActivity . Eventos LoggingEnabled Se genera cuando el canal de registro está asociado a una LoggingSession u otras herramientas de seguimiento y depuración de eventos. Consulte también LoggingSession FileLoggingSession ILoggingChannel IClosable Ejemplo de registro (Windows 10)