EventProviderTraceListener 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í.
Naslouchací proces, TraceSource který zapisuje události do subsystému ETW.
public ref class EventProviderTraceListener : System::Diagnostics::TraceListenerpublic class EventProviderTraceListener : System.Diagnostics.TraceListenertype EventProviderTraceListener = class
inherit TraceListenerPublic Class EventProviderTraceListener
Inherits TraceListener- Dědičnost
Příklady
private static Guid providerId = new Guid("{B3F0C8FC-E8A8-4868-8901-1465E8A2F41B}");
EventProviderTraceListener listener = new EventProviderTraceListener(providerId.ToString(), "Test Listener", "::");
// You should use the All default level and control the level using the
// ETW session; otherwise, you may not log all the events requested by the
// session.
TraceSource source = new TraceSource("MyProvider", SourceLevels.All);
source.Listeners.Add(listener);
source.TraceData(TraceEventType.Warning | TraceEventType.Start, 2, new object[] { "abc", "def", true, 123 });
source.TraceEvent(TraceEventType.Warning, 12, "Provider guid: {0}", new object[] { providerId });
source.TraceInformation("string {0}, bool {1}, int {2}, ushort {3}", new object[] { "abc", false, 123, (UInt32)5 });
Poznámky
Všechna data událostí (trasování nebo ladění) ze zdrojové události jsou zapsána do subsystému Trasování událostí pro Windows jako řetězec. Datové prvky jsou oddělené čárkou. Pokud chcete zadat jiný oddělovač, použijte Delimiter vlastnost .
Přidání naslouchacího procesu pro System.Diagnostics.TraceSource registraci zprostředkovatele do subsystému Trasování událostí pro Windows K zápisu událostí do souboru protokolu je nutné vytvořit relaci trasování událostí pro Windows pomocí spustitelného programu Logman.exe (nebo podobného).
K využívání událostí z naslouchacího procesu nepotřebujete manifest, protože data událostí jsou jeden řetězec.
Při volání System.Diagnostics.TraceSource metod zápisu událostí předáte hodnotu výčtu System.Diagnostics.TraceEventType . Výčet obsahuje hodnoty úrovně i klíčového slova. Když povolíte zprostředkovatele trasovacího naslouchacího procesu z relace Trasování událostí pro Windows, zadaná hodnota úrovně může být hodnotou přidruženou k jedné z následujících System.Diagnostics.TraceEventType hodnot výčtu:
Kritické (hodnota je 1)
Chyba (hodnota je 2)
Informace (hodnota je 8)
Podrobné (hodnota je 16)
Upozornění (hodnota je 4)
Hodnota klíčového slova, kterou zadáte pro relaci, může být hodnota přidružená k jedné z následujících System.Diagnostics.TraceEventType hodnot výčtu:
Resume (hodnota je 2 048)
Začátek (hodnota je 256)
Stop (hodnota je 512)
Pozastavit (hodnota je 1 024)
Převod (hodnota je 4 096)
Konstruktory
| EventProviderTraceListener(String) |
Inicializuje novou instanci EventProviderTraceListener třídy pomocí zadaného identifikátoru zprostředkovatele. |
| EventProviderTraceListener(String, String) |
Inicializuje novou instanci EventProviderTraceListener třídy pomocí zadaného identifikátoru zprostředkovatele a názvu naslouchacího procesu. |
| EventProviderTraceListener(String, String, String) |
Inicializuje novou instanci třídy pomocí zadaného identifikátoru EventProviderTraceListener zprostředkovatele, názvu naslouchacího procesu a oddělovače. |
Vlastnosti
| Attributes |
Získá vlastní atributy trasovacího naslouchacího procesu definované v konfiguračním souboru aplikace. (Zděděno od TraceListener) |
| Delimiter |
Získá nebo nastaví oddělovač použitý k oddělení dat událostí, která je zapsána do podsystému Trasování událostí pro Windows. |
| Filter |
Získá nebo nastaví filtr trasování pro trasovací naslouchací proces. (Zděděno od TraceListener) |
| IndentLevel |
Získá nebo nastaví úroveň odsazení. (Zděděno od TraceListener) |
| IndentSize |
Získá nebo nastaví počet mezer v odsazení. (Zděděno od TraceListener) |
| IsThreadSafe |
Získá hodnotu označující, zda trasovací naslouchací proces je bezpečný z více vláken. |
| Name |
Získá nebo nastaví název pro tento TraceListener. (Zděděno od TraceListener) |
| NeedIndent |
Získá nebo nastaví hodnotu označující, zda odsadit výstup. (Zděděno od TraceListener) |
| TraceOutputOptions |
Získá nebo nastaví možnosti výstupu trasování. (Zděděno od TraceListener) |
Metody
| Close() |
Zavře výstupní datový proud, aby už nepřijímaly výstup trasování nebo ladění. |
| CreateObjRef(Type) |
Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy používaného ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject) |
| Dispose() |
Uvolní všechny prostředky používané nástrojem TraceListener. (Zděděno od TraceListener) |
| Dispose(Boolean) |
Uvolní nespravované prostředky používané TraceListener nástrojem a volitelně uvolní spravované prostředky. (Zděděno od TraceListener) |
| Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
| Fail(String) |
Vygeneruje chybovou zprávu do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy. (Zděděno od TraceListener) |
| Fail(String, String) |
Vygeneruje chybovou zprávu a podrobnou chybovou zprávu do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy. |
| Flush() |
Vyprázdní výstupní vyrovnávací paměť. |
| GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
| GetLifetimeService() |
Zastaralé.
Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject) |
| GetSupportedAttributes() |
Získá vlastní atributy podporované trasovacím naslouchacím procesem. |
| GetType() |
Získá aktuální Type instanci. (Zděděno od Object) |
| InitializeLifetimeService() |
Zastaralé.
Získá objekt služby životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
| MemberwiseClone(Boolean) |
Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject) |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
Zapíše trasovací informace, datový objekt a informace o událostech do výstupu specifického pro naslouchací proces. |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Zapíše trasovací informace, datový objekt a informace o událostech do výstupu specifického pro naslouchací proces. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
Zapíše trasování a informace o událostech do výstupu specifického pro naslouchací proces. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
Zapíše informace o trasování, zprávu a informace o událostech do výstupu specifického pro naslouchací proces. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Zapisuje trasovací informace, formátované pole objektů a informace o událostech do výstupu specifického pro naslouchací proces. |
| TraceTransfer(TraceEventCache, String, Int32, String, Guid) |
Zapíše trasovací informace, zprávu, související identitu aktivity a informace o událostech do výstupu specifického pro naslouchací proces. |
| Write(Object) |
Zapíše hodnotu metody objektu ToString() do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy. (Zděděno od TraceListener) |
| Write(Object, String) |
Zapíše název kategorie a hodnotu metody objektu ToString() do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy. (Zděděno od TraceListener) |
| Write(String) |
Při přepsání v odvozené třídě zapíše zadanou zprávu do naslouchacího procesu, který vytvoříte v odvozené třídě. |
| Write(String, String) |
Zapíše název kategorie a zprávu do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy. (Zděděno od TraceListener) |
| WriteIndent() |
Zapíše odsazení do naslouchacího procesu, který vytvoříte při implementaci této třídy, a resetuje NeedIndent vlastnost na |
| WriteLine(Object) |
Zapíše hodnotu metody objektu ToString() do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy, následovaný ukončovacím znakem řádku. (Zděděno od TraceListener) |
| WriteLine(Object, String) |
Zapíše název kategorie a hodnotu metody objektu ToString() do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy, následovaný ukončovacím znakem řádku. (Zděděno od TraceListener) |
| WriteLine(String) |
Při přepsání v odvozené třídě zapíše zprávu do naslouchacího procesu, který vytvoříte v odvozené třídě, následovaný ukončovacím znakem řádku. |
| WriteLine(String, String) |
Zapíše název kategorie a zprávu naslouchacímu procesu, který vytvoříte při implementaci TraceListener třídy, následovaný ukončovacím znakem řádku. (Zděděno od TraceListener) |
