LoggingChannel Kelas

Definisi

Ruang nama:

Windows.Foundation.Diagnostics

Mewakili sumber pesan 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

Warisan

Object Platform::Object IInspectable LoggingChannel

Atribut

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Penerapan

IClosable IDisposable ILoggingChannel ILoggingTarget

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Keterangan

LoggingLevel default adalah Verbose.

Tambahkan instans LoggingChannel ke LoggingSession atau FileLoggingSession untuk mengaktifkan pengelogan di aplikasi Anda.

Metode LogMessage menyediakan cara untuk mencatat pesan string sederhana, sementara metode LogEvent menyediakan cara untuk mencatat data pelacakan yang lebih kompleks.

Windows 10 Dua mode operasi sekarang didukung: mode kompatibilitas Windows 8.1 dan perilaku baru yang didukung oleh Windows 10 dan yang lebih baru yang memungkinkan Anda mencatat sendiri peristiwa Pelacakan Peristiwa untuk Windows (ETW) tanpa manifes. + Untuk mode kompatibilitas Windows 8.1, buat objek menggunakan konstruktor LoggingChannel(String ).

• Untuk Windows 10 dan perilaku spesifik yang lebih baru, buat objek menggunakan konstruktor LoggingChannel(String, LoggingChannelOptions) atau LoggingChannel(String, LoggingChannelOptions, Guid). Perbedaan antara kedua mode ini adalah:

Mode kompatibilitas Windows 8.1	Windows 10 dan perilaku spesifik yang lebih baru
Beberapa peristiwa **LoggingChannel** dapat mereferensikan 4bd2826e-54a1-4ba9-bf63-92b73ea1ac4a yang merupakan [GUID](//windows/win32/api/guiddef/ns-guiddef-guid) untuk manifes **Microsoft-Windows-Diagnostics-LoggingChannel** yang tersedia di Windows 8.1 atau yang lebih baru.	Semua peristiwa menjelaskan sendiri. Tidak diperlukan manifes.
The Konstruktor LoggingChannel(String) Konstruktor ini membuat LoggingChannel dalam mode kompatibilitas Windows 8.1. LoggingChannel(String, LoggingChannelOptions) Menginisialisasi instans baru kelas LoggingChannel dengan opsi yang ditentukan. LoggingChannel(String, LoggingChannelOptions, Guid) Menginisialisasi instans baru kelas LoggingChannel dengan opsi dan ID saluran yang ditentukan. Properti Enabled Mendapatkan nilai yang menunjukkan apakah setidaknya satu sesi mencatat peristiwa dari saluran ini. Id Mengembalikan pengidentifikasi penyedia untuk saluran ini. Level Mendapatkan tingkat minimum di mana sesi apa pun mendengarkan peristiwa dari saluran ini. Name Mendapatkan nama LoggingChannel saat ini. Metode Close() Mengakhiri pengelogan pada saluran pengelogan saat ini. Dispose() Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, merilis, atau mengatur ulang sumber daya yang tidak dikelola. IsEnabled() Menunjukkan apakah setidaknya satu sesi mendengarkan peristiwa dari saluran. IsEnabled(LoggingLevel) Menunjukkan apakah setidaknya satu sesi mendengarkan peristiwa dengan tingkat keparahan peristiwa yang ditentukan dari saluran. IsEnabled(LoggingLevel, Int64) Menunjukkan apakah setidaknya satu sesi mendengarkan peristiwa dengan tingkat dan kata kunci yang ditentukan dari saluran ini. LogEvent(String) Mencatat peristiwa dengan nama yang ditentukan. LogEvent(String, LoggingFields) Mencatat peristiwa dengan nama dan bidang yang ditentukan. LogEvent(String, LoggingFields, LoggingLevel) Mencatat peristiwa dengan nama, bidang, dan tingkat yang ditentukan. LogEvent(String, LoggingFields, LoggingLevel, LoggingOptions) Mencatat peristiwa dengan nama, bidang, tingkat, dan opsi yang ditentukan. LogMessage(String) Mencatat pesan ke LoggingChannel saat ini. LogMessage(String, LoggingLevel) Mencatat pesan ke LoggingChannel saat ini dengan LoggingLevel yang ditentukan. LogValuePair(String, Int32) Mencatat data ke LoggingChannel saat ini. LogValuePair(String, Int32, LoggingLevel) Mencatat data ke LoggingChannel saat ini dengan LoggingLevel yang ditentukan. StartActivity(String) Menulis peristiwa mulai aktivitas dan membuat objek LoggingActivity . StartActivity(String, LoggingFields) Menulis peristiwa mulai aktivitas dengan bidang yang ditentukan dan membuat objek LoggingActivity . StartActivity(String, LoggingFields, LoggingLevel) Menulis peristiwa mulai aktivitas dengan bidang dan tingkat yang ditentukan, dan membuat objek LoggingActivity . StartActivity(String, LoggingFields, LoggingLevel, LoggingOptions) Menulis peristiwa mulai aktivitas dengan bidang, tingkat, dan opsi yang ditentukan, dan membuat objek LoggingActivity . Acara LoggingEnabled Muncul saat saluran pengelogan dilampirkan ke LoggingSession atau alat pelacakan dan penelusuran kesalahan peristiwa lainnya. Lihat juga LoggingSession FileLoggingSession ILoggingChannel IClosable Sampel pengelogan (Windows 10)