LoggingChannel Classe

Definizione

Spazio dei nomi:

Windows.Foundation.Diagnostics

Rappresenta un'origine di messaggi di log.

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

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. Vedi anche LoggingSession FileLoggingSession ILoggingChannel IClosable Esempio di registrazione (Windows 10)