LoggingChannel Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.Foundation.Diagnostics

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

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: ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni: IClosable IDisposable ILoggingChannel ILoggingTarget

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).

Per Windows 10 e un comportamento specifico successivo, creare l'oggetto usando il costruttore LoggingChannel(String, LoggingChannelOptions) o LoggingChannel(String, LoggingChannelOptions , Guid). Le differenze tra queste due modalità sono:

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

Condividi tramite