LoggingChannel Clase

Referencia

Definición

Espacio de nombres:: Windows.Foundation.Diagnostics

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Editar

Representa un origen de mensajes de registro.

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

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.

Se aplica a

Compartir a través de

LoggingChannel Clase

Definición

Requisitos de Windows

Comentarios

Constructores

Propiedades

Métodos

Eventos

Se aplica a

Consulte también

Comentarios

Recursos adicionales