LoggingSession Clase

Definición

Espacio de nombres:

Windows.Foundation.Diagnostics

Representa el destino de los mensajes registrados de las instancias de LoggingChannel .

public ref class LoggingSession sealed : ILoggingSession, 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.ILoggingSessionFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class LoggingSession final : ILoggingSession, 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.ILoggingSessionFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class LoggingSession : System.IDisposable, ILoggingSession

function LoggingSession(name)

Public NotInheritable Class LoggingSession
Implements IDisposable, ILoggingSession

Herencia

Object Platform::Object IInspectable LoggingSession

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementaciones

IClosable IDisposable ILoggingSession

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

Usa la clase LoggingSession para registrar mensajes y datos en un búfer circular en memoria a medida que se ejecuta la aplicación. Use el método SaveToFileAsync para guardar el búfer en un archivo. Puede ver los archivos de registro mediante Windows Performance Toolkit (WPT) y otras utilidades como tracerpt.exe.

Las instancias de LoggingSession mantienen los mensajes registrados en la memoria hasta que se llama al método SaveToFileAsync . Esto permite el guardado a petición de eventos hasta que la aplicación guarde los mensajes en memoria.

Agregue instancias de LoggingChannel a LoggingSession y llame a los métodos de instancia de LoggingSession para quitar canales, eliminar y realizar otras operaciones.

LoggingSession registra los 260 KB más recientes de eventos, después de lo cual comenzará a sobrescribir eventos anteriores.

No puede tener más de una sesión con el mismo nombre. Además, cada aplicación está limitada a 4 sesiones en total.

Constructores

LoggingSession(String)

Inicializa una nueva instancia de la clase LoggingSession .

Propiedades

Name	Obtiene el nombre de la sesión de registro.

Métodos

AddLoggingChannel(ILoggingChannel)	Agrega un canal de registro a la sesión de registro actual.
AddLoggingChannel(ILoggingChannel, LoggingLevel)	Agrega un canal de registro con el nivel de registro especificado a la sesión de registro actual.
Close()	Finaliza la sesión de registro actual.
Dispose()	Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados.
RemoveLoggingChannel(ILoggingChannel)	Quita el canal de registro especificado de la sesión de registro actual.
SaveToFileAsync(IStorageFolder, String)	Guarda la sesión de registro actual en un archivo.

Consulte también

• LoggingChannel
• ILoggingSession
• IClosable
• Ejemplo de registro (Windows 10)