LoggingChannel Classe

Definizione

Rappresenta un'origine di messaggi di log.

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
Ereditarietà
Object Platform::Object IInspectable LoggingChannel
Attributi
Implementazioni

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

L'impostazione predefinita LoggingLevel è dettagliata.

Aggiungere istanze di LoggingChannel a una registrazioneSession o a FileLoggingSession per abilitare la registrazione nell'app.

I metodi LogMessage forniscono modi per registrare messaggi di stringa semplici, mentre i metodi LogEvent forniscono modi per registrare dati di traccia più complessi.

Windows 10 Sono ora supportate due modalità di operazione: Windows 8.1 modalità di compatibilità e il nuovo comportamento supportato da Windows 10 e versioni successive, che consente di registrare eventi autodescrizione eventi per Windows (ETW) senza un manifesto. + Per Windows 8.1 modalità di compatibilità, creare l'oggetto usando il costruttore LoggingChannel(String).

Windows 8.1 modalità di compatibilitàWindows 10 e un comportamento specifico successivo
Alcuni eventi **LoggingChannel** possono fare riferimento a 4bd2826e-54a1-4ba9-bf63-92b73ea1ac4a che è la [GUID](/windows/win32/api/guiddef/ns-guiddef-guidd) per il manifesto **Microsoft-Windows-Diagnostics-LoggingChannel** disponibile in Windows 8.1 o versione successiva.Tutti gli eventi sono autodescrizione. Non è necessario alcun manifesto.
The

Costruttori

LoggingChannel(String)

Questo costruttore crea un oggetto LoggingChannel in Windows 8.1 modalità di compatibilità.

LoggingChannel(String, LoggingChannelOptions)

Inizializza una nuova istanza della classe LoggingChannel con le opzioni specificate.

LoggingChannel(String, LoggingChannelOptions, Guid)

Inizializza una nuova istanza della classe LoggingChannel con le opzioni e l'ID canale specificati.

Proprietà

Enabled

Ottiene un valore che indica se almeno una sessione registra gli eventi da questo canale.

Id

Restituisce l'identificatore del provider per questo canale.

Level

Ottiene il livello minimo in cui qualsiasi sessione è in ascolto di eventi da questo canale.

Name

Ottiene il nome dell'oggetto LoggingChannel corrente.

Metodi

Close()

Termina la registrazione nel canale di registrazione corrente.

Dispose()

Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite.

IsEnabled()

Indica se almeno una sessione è in ascolto degli eventi dal canale.

IsEnabled(LoggingLevel)

Indica se almeno una sessione è in ascolto degli eventi con il livello di gravità dell'evento specificato dal canale.

IsEnabled(LoggingLevel, Int64)

Indica se almeno una sessione è in ascolto degli eventi con il livello e le parole chiave specificati da questo canale.

LogEvent(String)

Registra un evento con il nome specificato.

LogEvent(String, LoggingFields)

Registra un evento con il nome e i campi specificati.

LogEvent(String, LoggingFields, LoggingLevel)

Registra un evento con il nome, i campi e il livello specificati.

LogEvent(String, LoggingFields, LoggingLevel, LoggingOptions)

Registra un evento con il nome, i campi, il livello e le opzioni specificati.

LogMessage(String)

Registra un messaggio all'oggetto LoggingChannel corrente.

LogMessage(String, LoggingLevel)

Registra un messaggio all'oggetto LoggingChannel corrente con l'oggetto LoggingLevel specificato.

LogValuePair(String, Int32)

Registra i dati nell'oggetto LoggingChannel corrente.

LogValuePair(String, Int32, LoggingLevel)

Registra i dati nell'oggetto LoggingChannel corrente con l'oggetto LoggingLevel specificato.

StartActivity(String)

Scrive un evento di avvio attività e crea un oggetto LoggingActivity .

StartActivity(String, LoggingFields)

Scrive un evento di inizio attività con i campi specificati e crea un oggetto LoggingActivity .

StartActivity(String, LoggingFields, LoggingLevel)

Scrive un evento di inizio attività con i campi e il livello specificati e crea un oggetto LoggingActivity .

StartActivity(String, LoggingFields, LoggingLevel, LoggingOptions)

Scrive un evento di inizio attività con i campi, il livello e le opzioni specificati e crea un oggetto LoggingActivity .

Eventi

LoggingEnabled

Generato quando il canale di registrazione è collegato a una registrazioneSession o ad altri strumenti di traccia eventi e debug.

Si applica a

Vedi anche