LoggingEventSource Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
LoggingEventSource je most ze všech protokolování založených na ILoggeru na protokolování 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- Dědičnost
- Atributy
Příklady
Následující příklad ukazuje, jak použít EventListener k získání informací o 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]);
}
}
Poznámky
Toto protokolování zapnete tak, že povolíte EventSource s názvem Microsoft-Extensions-Logging.
Když jste povolili EventSource, nastavená úroveň události se přeloží zřejmým způsobem na úroveň přidruženou k ILoggeru (tedy Debug = verbose, Informational = Informational ... Kritické == Kritické)
To vám umožní jednoduše filtrovat podle úrovně událostí.
Pro jemnější kontrolu můžete zadat argument EventSource s názvem FilterSpecs.
Argument FilterSpecs je seznam specifikací oddělený středníkem. Kde je každá specifikace
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).
Kde Název je název ILoggeru (záleží na malých a malých a malých písmenech), název může mít znak *, který funguje jako zástupný znak JAKO PŘÍPONA. Hodnota Net* se tedy bude shodovat se všemi protokolovacími nástroji, které začínají na "Net".
Level je číslo nebo řetězec LogLevel. 0= trasování, 1 = ladění, 2 = informace, 3 = upozornění, 4 = chyba, kritické = 5 Určuje úroveň přidruženého vzoru. Pokud není zadané číslo (první forma specifikace), jedná se o výchozí úroveň pro EventSource.
První shoda se použije, pokud konkrétní název odpovídá více než jednomu vzoru.
Kromě level a argumentu FilterSpec můžete nastavit také klíčová slova EventSource. Podívejte se na definici klíčových slov níže, ale v podstatě se můžete rozhodnout, jestli chcete
- Keywords.Message – událost získáte s daty v analyzované podobě.
- Keywords.JsonMessage – získáte událost s daty ve formě parse, ale jako objekt blob JSON (nerozdělí se podle argumentu ...).
- Keywords.FormattedMessage – získáte událost s daty formátovanými jako řetězec.
Očekává se, že najednou zapnete jenom jedno z těchto klíčových slov, ale můžete je zapnout všechna a získat stejná data zaprotokolovaná třemi různými způsoby.
Vlastnosti
| ConstructionException |
Získá jakoukoli výjimku, která byla vyvolán během vytváření zdroje událostí. (Zděděno od EventSource) |
| Guid |
Jedinečný identifikátor zdroje událostí. (Zděděno od EventSource) |
| Name |
Popisný název třídy, která je odvozena ze zdroje událostí. (Zděděno od EventSource) |
| Settings |
Získá nastavení použité pro tento zdroj událostí. (Zděděno od EventSource) |
Metody
| Dispose() |
Uvolní všechny prostředky používané aktuální instancí EventSource třídy . (Zděděno od EventSource) |
| Dispose(Boolean) |
Uvolní nespravované prostředky používané EventSource třídou a volitelně uvolní spravované prostředky. (Zděděno od EventSource) |
| Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
| GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
| GetTrait(String) |
Získá hodnotu vlastnosti přidružené k zadanému klíči. (Zděděno od EventSource) |
| GetType() |
Type Získá z aktuální instance. (Zděděno od Object) |
| IsEnabled() |
Určuje, zda je povolen aktuální zdroj událostí. (Zděděno od EventSource) |
| IsEnabled(EventLevel, EventKeywords) |
Určuje, zda je povolen aktuální zdroj událostí, který má zadanou úroveň a klíčové slovo. (Zděděno od EventSource) |
| IsEnabled(EventLevel, EventKeywords, EventChannel) |
Určuje, jestli je aktuální zdroj událostí povolený pro události se zadanou úrovní, klíčovými slovy a kanálem. (Zděděno od EventSource) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
| OnEventCommand(EventCommandEventArgs) |
Volá se při aktualizaci aktuálního zdroje událostí kontrolerem. (Zděděno od EventSource) |
| ToString() |
Získá řetězcovou reprezentaci aktuální instance zdroje událostí. (Zděděno od EventSource) |
| Write(String) |
Zapíše událost bez polí, ale se zadaným názvem a výchozími možnostmi. (Zděděno od EventSource) |
| Write(String, EventSourceOptions) |
Zapíše událost bez polí, ale se zadaným názvem a možnostmi. (Zděděno od EventSource) |
| Write<T>(String, EventSourceOptions, Guid, Guid, T) |
Zapíše událost se zadaným názvem, možnostmi, související aktivitou a daty události. (Zděděno od EventSource) |
| Write<T>(String, EventSourceOptions, T) |
Zapíše událost se zadaným názvem, daty události a možnostmi. (Zděděno od EventSource) |
| Write<T>(String, EventSourceOptions, T) |
Zapíše událost se zadaným názvem, možnostmi a daty události. (Zděděno od EventSource) |
| Write<T>(String, T) |
Zapíše událost se zadaným názvem a daty. (Zděděno od EventSource) |
| WriteEvent(Int32) |
Zapíše událost pomocí zadaného identifikátoru události. (Zděděno od EventSource) |
| WriteEvent(Int32, Byte[]) |
Zapíše událost pomocí zadaného identifikátoru události a argumentu pole bajtů. (Zděděno od EventSource) |
| WriteEvent(Int32, EventSource+EventSourcePrimitive[]) |
Zapíše událost pomocí zadaného identifikátoru události a proměnné počtu primitiv zdroje událostí. (Zděděno od EventSource) |
| WriteEvent(Int32, Int32) |
Zapíše událost pomocí zadaného identifikátoru události a 32bitového celočíselného argumentu. (Zděděno od EventSource) |
| WriteEvent(Int32, Int32, Int32) |
Zapíše událost pomocí zadaného identifikátoru události a 32bitových celočíselných argumentů. (Zděděno od EventSource) |
| WriteEvent(Int32, Int32, Int32, Int32) |
Zapíše událost pomocí zadaného identifikátoru události a 32bitových celočíselných argumentů. (Zděděno od EventSource) |
| WriteEvent(Int32, Int32, String) |
Zapíše událost pomocí zadaného identifikátoru události a 32bitových celočíselných a řetězcových argumentů. (Zděděno od EventSource) |
| WriteEvent(Int32, Int64) |
Zapíše událost pomocí zadaného identifikátoru události a 64bitového celočíselného argumentu. (Zděděno od EventSource) |
| WriteEvent(Int32, Int64, Byte[]) |
Zapíše data události pomocí zadaného identifikátoru a argumentů 64bitového celočíselného a bajtového pole. (Zděděno od EventSource) |
| WriteEvent(Int32, Int64, Int64) |
Zapíše událost pomocí zadaného identifikátoru události a 64bitových argumentů. (Zděděno od EventSource) |
| WriteEvent(Int32, Int64, Int64, Int64) |
Zapíše událost pomocí zadaného identifikátoru události a 64bitových argumentů. (Zděděno od EventSource) |
| WriteEvent(Int32, Int64, String) |
Zapíše událost pomocí zadaného identifikátoru události, 64bitového celého čísla a řetězcových argumentů. (Zděděno od EventSource) |
| WriteEvent(Int32, Object[]) |
Zapíše událost pomocí zadaného identifikátoru události a pole argumentů. (Zděděno od EventSource) |
| WriteEvent(Int32, String) |
Zapíše událost pomocí zadaného identifikátoru události a argumentu řetězce. (Zděděno od EventSource) |
| WriteEvent(Int32, String, Int32) |
Zapíše událost pomocí zadaného identifikátoru a argumentů události. (Zděděno od EventSource) |
| WriteEvent(Int32, String, Int32, Int32) |
Zapíše událost pomocí zadaného identifikátoru a argumentů události. (Zděděno od EventSource) |
| WriteEvent(Int32, String, Int64) |
Zapíše událost pomocí zadaného identifikátoru a argumentů události. (Zděděno od EventSource) |
| WriteEvent(Int32, String, String) |
Zapíše událost pomocí zadaného identifikátoru události a řetězcových argumentů. (Zděděno od EventSource) |
| WriteEvent(Int32, String, String, String) |
Zapíše událost pomocí zadaného identifikátoru události a řetězcových argumentů. (Zděděno od EventSource) |
| WriteEventCore(Int32, Int32, EventSource+EventData*) |
Vytvoří nové WriteEvent přetížení pomocí zadaného identifikátoru události a dat události. (Zděděno od EventSource) |
| WriteEventWithRelatedActivityId(Int32, Guid, Object[]) |
Zapíše událost, která označuje, že aktuální aktivita souvisí s jinou aktivitou. (Zděděno od EventSource) |
| WriteEventWithRelatedActivityIdCore(Int32, Guid*, Int32, EventSource+EventData*) |
Zapíše událost, která označuje, že aktuální aktivita souvisí s jinou aktivitou. (Zděděno od EventSource) |
Událost
| EventCommandExecuted |
Vyvolá se, když příkaz pochází z naslouchacího procesu událostí. (Zděděno od EventSource) |
