LoggingEventSource Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
LoggingEventSource adalah jembatan dari semua pengelogan berbasis ILogger ke pengelogan EventSource/EventListener.
public ref class LoggingEventSource sealed : System::Diagnostics::Tracing::EventSource[System.Diagnostics.Tracing.EventSource(Name="Microsoft-Extensions-Logging")]
public sealed class LoggingEventSource : System.Diagnostics.Tracing.EventSource[<System.Diagnostics.Tracing.EventSource(Name="Microsoft-Extensions-Logging")>]
type LoggingEventSource = class
inherit EventSourcePublic NotInheritable Class LoggingEventSource
Inherits EventSource- Warisan
- Atribut
Contoh
Contoh berikut menunjukkan cara menggunakan EventListener untuk mendapatkan informasi ILogging:
class MyEventListener : EventListener
{
protected override void OnEventSourceCreated(EventSource eventSource)
{
if (eventSource.Name == "Microsoft-Extensions-Logging")
{
// initialize a string, string dictionary of arguments to pass to the EventSource.
// Turn on loggers matching App* to Information, everything else (*) is the default level (which is EventLevel.Error)
var args = new Dictionary<string, string>() { { "FilterSpecs", "App*:Information;*" } };
// Set the default level (verbosity) to Error, and only ask for the formatted messages in this case.
EnableEvents(eventSource, EventLevel.Error, LoggingEventSource.Keywords.FormattedMessage, args);
}
}
protected override void OnEventWritten(EventWrittenEventArgs eventData)
{
// Look for the formatted message event, which has the following argument layout (as defined in the LoggingEventSource.
// FormattedMessage(LogLevel Level, int FactoryID, string LoggerName, string EventId, string FormattedMessage);
if (eventData.EventName == "FormattedMessage")
Console.WriteLine("Logger {0}: {1}", eventData.Payload[2], eventData.Payload[4]);
}
}
Keterangan
Anda mengaktifkan pengelogan ini dengan mengaktifkan EventSource yang disebut Microsoft-Extensions-Logging.
Ketika Anda mengaktifkan EventSource, EventLevel yang Anda tetapkan diterjemahkan dengan cara yang jelas ke tingkat yang terkait dengan ILogger (dengan demikian Debug = verbose, Informasi = Informasi ... Kritis == Kritis)
Ini memungkinkan Anda untuk memfilter berdasarkan tingkat peristiwa dengan cara yang mudah.
Untuk kontrol yang lebih baik, Anda dapat menentukan Argumen EventSource yang disebut FilterSpecs.
Argumen FilterSpecs adalah daftar spesifikasi yang dipisahkan titik koma. Di mana setiap spesifikasi adalah
SPEC = // empty spec, same as *
| NAME // Just a name the level is the default level
| NAME : LEVEL // specifies level for a particular logger (can have a * suffix).
Di mana Nama adalah nama ILogger (kasus penting), Nama dapat memiliki * yang bertindak sebagai kartubebas SEBAGAI AKHIRAN. Dengan demikian, Net* akan cocok dengan pencatat apa pun yang dimulai dengan 'Net'.
LEVEL adalah angka atau string LogLevel. 0=Trace, 1=Debug, 2=Information, 3=Warning, 4=Error, Critical=5 Ini menentukan level untuk pola terkait. Jika angka tidak ditentukan, (bentuk pertama spesifikasi) itu adalah tingkat default untuk EventSource.
Kecocokan pertama digunakan jika nama tertentu cocok dengan lebih dari satu pola.
Selain tingkat dan argumen FilterSpec, Anda juga dapat mengatur Kata Kunci EventSource. Lihat definisi Kata Kunci di bawah ini, tetapi pada dasarnya Anda dapat memutuskan apakah Anda ingin memiliki
- Keywords.Message - Anda mendapatkan peristiwa dengan data dalam formulir yang diurai.
- Kata kunci.JsonMessage - Anda mendapatkan peristiwa dengan data dalam bentuk penguraian tetapi sebagai blob JSON (tidak dipecah berdasarkan argumen ...)
- Kata kunci.FormattedMessage - Anda mendapatkan peristiwa dengan data yang diformat sebagai string
Diharapkan bahwa Anda hanya akan mengaktifkan salah satu kata kunci ini pada satu waktu, tetapi Anda dapat mengaktifkan semuanya dan mendapatkan data yang sama yang dicatat dengan tiga cara yang berbeda.
Properti
| ConstructionException |
Mendapatkan pengecualian apa pun yang dilemparkan selama pembangunan sumber peristiwa. (Diperoleh dari EventSource) |
| Guid |
Pengidentifikasi unik untuk sumber peristiwa. (Diperoleh dari EventSource) |
| Name |
Nama yang mudah diingat dari kelas yang berasal dari sumber peristiwa. (Diperoleh dari EventSource) |
| Settings |
Mendapatkan pengaturan yang diterapkan ke sumber kejadian ini. (Diperoleh dari EventSource) |
Metode
| Dispose() |
Merilis semua sumber daya yang digunakan oleh instans EventSource kelas saat ini. (Diperoleh dari EventSource) |
| Dispose(Boolean) |
Merilis sumber daya tidak terkelola yang EventSource digunakan oleh kelas dan secara opsional merilis sumber daya terkelola. (Diperoleh dari EventSource) |
| Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
| GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
| GetTrait(String) |
Mendapatkan nilai sifat yang terkait dengan kunci yang ditentukan. (Diperoleh dari EventSource) |
| GetType() |
Mendapatkan instans Type saat ini. (Diperoleh dari Object) |
| IsEnabled() |
Menentukan apakah sumber kejadian saat ini diaktifkan. (Diperoleh dari EventSource) |
| IsEnabled(EventLevel, EventKeywords) |
Menentukan apakah sumber peristiwa saat ini yang memiliki tingkat dan kata kunci yang ditentukan diaktifkan. (Diperoleh dari EventSource) |
| IsEnabled(EventLevel, EventKeywords, EventChannel) |
Menentukan apakah sumber peristiwa saat ini diaktifkan untuk peristiwa dengan tingkat, kata kunci, dan saluran yang ditentukan. (Diperoleh dari EventSource) |
| MemberwiseClone() |
Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object) |
| OnEventCommand(EventCommandEventArgs) |
Dipanggil ketika sumber peristiwa saat ini diperbarui oleh pengontrol. (Diperoleh dari EventSource) |
| ToString() |
Mendapatkan representasi string dari instans sumber peristiwa saat ini. (Diperoleh dari EventSource) |
| Write(String) |
Menulis peristiwa tanpa bidang, tetapi dengan nama dan opsi default yang ditentukan. (Diperoleh dari EventSource) |
| Write(String, EventSourceOptions) |
Menulis peristiwa tanpa bidang, tetapi dengan nama dan opsi yang ditentukan. (Diperoleh dari EventSource) |
| Write<T>(String, EventSourceOptions, Guid, Guid, T) |
Menulis peristiwa dengan nama, opsi, aktivitas terkait, dan data peristiwa yang ditentukan. (Diperoleh dari EventSource) |
| Write<T>(String, EventSourceOptions, T) |
Menulis peristiwa dengan nama, data peristiwa, dan opsi yang ditentukan. (Diperoleh dari EventSource) |
| Write<T>(String, EventSourceOptions, T) |
Menulis peristiwa dengan nama, opsi, dan data peristiwa yang ditentukan. (Diperoleh dari EventSource) |
| Write<T>(String, T) |
Menulis peristiwa dengan nama dan data yang ditentukan. (Diperoleh dari EventSource) |
| WriteEvent(Int32) |
Menulis peristiwa dengan menggunakan pengidentifikasi peristiwa yang disediakan. (Diperoleh dari EventSource) |
| WriteEvent(Int32, Byte[]) |
Menulis peristiwa dengan menggunakan pengidentifikasi peristiwa yang disediakan dan argumen array byte. (Diperoleh dari EventSource) |
| WriteEvent(Int32, EventSource+EventSourcePrimitive[]) |
Menulis peristiwa dengan menggunakan pengidentifikasi peristiwa yang disediakan dan jumlah variabel primitif sumber peristiwa. (Diperoleh dari EventSource) |
| WriteEvent(Int32, Int32) |
Menulis peristiwa dengan menggunakan pengidentifikasi peristiwa yang disediakan dan argumen bilangan bulat 32-bit. (Diperoleh dari EventSource) |
| WriteEvent(Int32, Int32, Int32) |
Menulis peristiwa dengan menggunakan pengidentifikasi peristiwa yang disediakan dan argumen bilangan bulat 32-bit. (Diperoleh dari EventSource) |
| WriteEvent(Int32, Int32, Int32, Int32) |
Menulis peristiwa dengan menggunakan pengidentifikasi peristiwa yang disediakan dan argumen bilangan bulat 32-bit. (Diperoleh dari EventSource) |
| WriteEvent(Int32, Int32, String) |
Menulis peristiwa dengan menggunakan pengidentifikasi peristiwa yang disediakan dan argumen bilangan bulat dan string 32-bit. (Diperoleh dari EventSource) |
| WriteEvent(Int32, Int64) |
Menulis peristiwa dengan menggunakan pengidentifikasi peristiwa yang disediakan dan argumen bilangan bulat 64-bit. (Diperoleh dari EventSource) |
| WriteEvent(Int32, Int64, Byte[]) |
Menulis data peristiwa menggunakan pengidentifikasi yang ditentukan dan argumen array bilangan bulat dan byte 64-bit. (Diperoleh dari EventSource) |
| WriteEvent(Int32, Int64, Int64) |
Menulis peristiwa dengan menggunakan pengidentifikasi peristiwa yang disediakan dan argumen 64-bit. (Diperoleh dari EventSource) |
| WriteEvent(Int32, Int64, Int64, Int64) |
Menulis peristiwa dengan menggunakan pengidentifikasi peristiwa yang disediakan dan argumen 64-bit. (Diperoleh dari EventSource) |
| WriteEvent(Int32, Int64, String) |
Menulis peristiwa dengan menggunakan pengidentifikasi peristiwa yang disediakan dan bilangan bulat 64-bit, dan argumen string. (Diperoleh dari EventSource) |
| WriteEvent(Int32, Object[]) |
Menulis peristiwa dengan menggunakan pengidentifikasi peristiwa yang disediakan dan array argumen. (Diperoleh dari EventSource) |
| WriteEvent(Int32, String) |
Menulis peristiwa dengan menggunakan pengidentifikasi peristiwa dan argumen string yang disediakan. (Diperoleh dari EventSource) |
| WriteEvent(Int32, String, Int32) |
Menulis peristiwa dengan menggunakan pengidentifikasi peristiwa dan argumen yang disediakan. (Diperoleh dari EventSource) |
| WriteEvent(Int32, String, Int32, Int32) |
Menulis peristiwa dengan menggunakan pengidentifikasi peristiwa dan argumen yang disediakan. (Diperoleh dari EventSource) |
| WriteEvent(Int32, String, Int64) |
Menulis peristiwa dengan menggunakan pengidentifikasi peristiwa dan argumen yang disediakan. (Diperoleh dari EventSource) |
| WriteEvent(Int32, String, String) |
Menulis peristiwa dengan menggunakan pengidentifikasi peristiwa dan argumen string yang disediakan. (Diperoleh dari EventSource) |
| WriteEvent(Int32, String, String, String) |
Menulis peristiwa dengan menggunakan pengidentifikasi peristiwa dan argumen string yang disediakan. (Diperoleh dari EventSource) |
| WriteEventCore(Int32, Int32, EventSource+EventData*) |
Membuat kelebihan beban baru WriteEvent dengan menggunakan pengidentifikasi peristiwa dan data peristiwa yang disediakan. (Diperoleh dari EventSource) |
| WriteEventWithRelatedActivityId(Int32, Guid, Object[]) |
Menulis peristiwa yang menunjukkan bahwa aktivitas saat ini terkait dengan aktivitas lain. (Diperoleh dari EventSource) |
| WriteEventWithRelatedActivityIdCore(Int32, Guid*, Int32, EventSource+EventData*) |
Menulis peristiwa yang menunjukkan bahwa aktivitas saat ini terkait dengan aktivitas lain. (Diperoleh dari EventSource) |
Acara
| EventCommandExecuted |
Terjadi ketika perintah berasal dari pendengar peristiwa. (Diperoleh dari EventSource) |
