LoggingEventSource 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
LoggingEventSource 是所有 ILogger 式記錄與 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- 繼承
- 屬性
範例
下列範例示範如何使用 EventListener 來取得 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]);
}
}
備註
您可以啟用名為 Microsoft-Extensions-Logging 的 EventSource 來開啟此記錄。
當您啟用 EventSource 時，您設定的 EventLevel 會以明顯的方式轉譯為與 ILogger 相關聯的層級 (因此 Debug = verbose、Informational = Informational ...Critical == Critical)
這可以讓您以直接的方式篩選事件層級。
如需更精細的控制，您可以指定名為 的 FilterSpecs EventSource 引數。
自 FilterSpecs 變數是以分號分隔的規格清單。 其中每個規格都是
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).
其中 Name 是 ILogger (大小寫的名稱很重要) ，Name 可以有 * 作為萬用字元 AS A SUFFIX。 因此，Net* 會比對任何以 'Net' 開頭的記錄器。
LEVEL 是數字或 LogLevel 字串。 0=Trace、1=Debug、2=Information、3=Warning、4=Error、Critical=5 這會指定相關聯模式的層級。 若沒有指定數字 (規格的第一種形式)，則為 EventSource 的預設層級。
若與特定名稱相符的模式超過一種，則會使用第一個相符項目。
除了 level 和 FilterSpec 引數之外，您也可以設定 EventSource 關鍵字。 請參閱以下的關鍵字定義，但基本上您必須決定您想要的是：
- Keywords.Message - 您會以剖析形式取得具有資料的事件。
- Keywords.JsonMessage - 您會以剖析形式取得具有資料的事件，但 JSON Blob (未依引數分割 ...)
- Keywords.FormattedMessage - 您會取得資料格式化為字串的事件
預期您一次只會開啟其中一個關鍵字，但您可以全部開啟，並取得記錄三種不同方式的相同資料。
屬性
| ConstructionException |
取得事件來源建構期間擲回的任何例外狀況。 (繼承來源 EventSource) |
| Guid |
事件來源的唯一識別項。 (繼承來源 EventSource) |
| Name |
衍生自事件來源的類別的好記名稱。 (繼承來源 EventSource) |
| Settings |
取得套用至這個事件來源的設定。 (繼承來源 EventSource) |
方法
事件
| EventCommandExecuted |
發生於命令來自事件接聽程式時。 (繼承來源 EventSource) |
