EventProviderTraceListener Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Diagnostics.Eventing

Zestaw:: System.Core.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Odbiornik, który TraceSource zapisuje zdarzenia w podsystemie ETW.

public ref class EventProviderTraceListener : System::Diagnostics::TraceListener

public class EventProviderTraceListener : System.Diagnostics.TraceListener

type EventProviderTraceListener = class
    inherit TraceListener

Public Class EventProviderTraceListener
Inherits TraceListener

Dziedziczenie: Object

MarshalByRefObject

TraceListener
EventProviderTraceListener

Przykłady

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 });

Uwagi

Wszystkie dane zdarzenia (śledzenie lub debugowanie) ze zdarzenia źródłowego są zapisywane w podsystemie ETW jako ciąg. Elementy danych są rozdzielane przecinkami. Aby określić inny ogranicznik, użyj Delimiter właściwości .

Dodanie odbiornika w celu System.Diagnostics.TraceSource zarejestrowania dostawcy za pomocą podsystemu ETW. Należy utworzyć sesję śledzenia ETW przy użyciu programu wykonywalnego Logman.exe (lub podobnego), aby zapisać zdarzenia w pliku dziennika.

Nie potrzebujesz manifestu, aby korzystać ze zdarzeń z odbiornika, ponieważ dane zdarzenia są pojedynczym ciągiem.

Podczas wywoływania System.Diagnostics.TraceSource metod zapisu zdarzeń należy przekazać System.Diagnostics.TraceEventType wartość wyliczenia. Wyliczenie zawiera zarówno wartości poziomów, jak i słów kluczowych. Po włączeniu dostawcy odbiornika śledzenia z sesji ETW określona wartość poziomu może być wartością skojarzona z jedną z następujących System.Diagnostics.TraceEventType wartości wyliczenia:

Krytyczne (wartość to 1)
Błąd (wartość to 2)
Informacje (wartość to 8)
Pełne (wartość to 16)
Ostrzeżenie (wartość to 4)

Wartość słowa kluczowego określona dla sesji może być wartością skojarzona z jedną z następujących System.Diagnostics.TraceEventType wartości wyliczenia:

Resume (wartość to 2048)
Początek (wartość to 256)
Stop (wartość to 512)
Suspend (wartość to 1024)
Transfer (wartość to 4096)

Konstruktory

EventProviderTraceListener(String)	Inicjuje EventProviderTraceListener nowe wystąpienie klasy przy użyciu określonego identyfikatora dostawcy.
EventProviderTraceListener(String, String)	Inicjuje nowe wystąpienie EventProviderTraceListener klasy przy użyciu określonego identyfikatora dostawcy i nazwy odbiornika.
EventProviderTraceListener(String, String, String)	Inicjuje nowe wystąpienie EventProviderTraceListener klasy przy użyciu określonego identyfikatora dostawcy, nazwy odbiornika i ogranicznika.

Właściwości

Attributes	Pobiera atrybuty niestandardowego odbiornika śledzenia zdefiniowane w pliku konfiguracji aplikacji. (Odziedziczone po TraceListener)
Delimiter	Pobiera lub ustawia ogranicznik używany do rozdzielania danych zdarzeń zapisywanych w podsystemie ETW.
Filter	Pobiera lub ustawia filtr śledzenia dla odbiornika śledzenia. (Odziedziczone po TraceListener)
IndentLevel	Pobiera lub ustawia poziom wcięcia. (Odziedziczone po TraceListener)
IndentSize	Pobiera lub ustawia liczbę spacji w wcięcie. (Odziedziczone po TraceListener)
IsThreadSafe	Pobiera wartość wskazującą, czy odbiornik śledzenia jest bezpieczny wątkiem.
Name	Pobiera lub ustawia nazwę dla tego TraceListenerelementu . (Odziedziczone po TraceListener)
NeedIndent	Pobiera lub ustawia wartość wskazującą, czy wcięć dane wyjściowe. (Odziedziczone po TraceListener)
TraceOutputOptions	Pobiera lub ustawia opcje danych wyjściowych śledzenia. (Odziedziczone po TraceListener)

Metody

Close()	Zamyka strumień wyjściowy, aby nie odbierał już danych wyjściowych śledzenia ani debugowania.
CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Zwalnia wszelkie zasoby używane przez element TraceListener. (Odziedziczone po TraceListener)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element TraceListener i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po TraceListener)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
Fail(String)	Emituje komunikat o błędzie do odbiornika utworzonego podczas implementowania TraceListener klasy . (Odziedziczone po TraceListener)
Fail(String, String)	Emituje komunikat o błędzie i szczegółowy komunikat o błędzie do odbiornika tworzonego podczas implementowania TraceListener klasy.
Flush()	Opróżnia bufor wyjściowy.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Przestarzałe. Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetSupportedAttributes()	Pobiera atrybuty niestandardowe obsługiwane przez odbiornik śledzenia.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
InitializeLifetimeService()	Przestarzałe. Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Zapisuje informacje śledzenia, obiekt danych i informacje o zdarzeniu do danych wyjściowych specyficznych dla odbiornika.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Zapisuje informacje śledzenia, obiekt danych i informacje o zdarzeniu do danych wyjściowych specyficznych dla odbiornika.
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Zapisuje informacje o śledzeniu i zdarzeniu do danych wyjściowych specyficznych dla odbiornika.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Zapisuje informacje śledzenia, komunikat i informacje o zdarzeniu do danych wyjściowych specyficznych dla odbiornika.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Zapisuje informacje śledzenia, sformatowaną tablicę obiektów i informacji o zdarzeniach do danych wyjściowych specyficznych dla odbiornika.
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	Zapisuje informacje śledzenia, komunikat, powiązaną tożsamość działania i informacje o zdarzeniu do danych wyjściowych specyficznych dla odbiornika.
Write(Object)	Zapisuje wartość metody obiektu ToString() w odbiorniku tworzonym podczas implementowania TraceListener klasy . (Odziedziczone po TraceListener)
Write(Object, String)	Zapisuje nazwę kategorii i wartość metody obiektu ToString() do odbiornika tworzonego podczas implementowania TraceListener klasy. (Odziedziczone po TraceListener)
Write(String)	Po przesłonięcia w klasie pochodnej zapisuje określony komunikat do odbiornika utworzonego w klasie pochodnej.
Write(String, String)	Zapisuje nazwę kategorii i komunikat do odbiornika utworzonego podczas implementowania TraceListener klasy. (Odziedziczone po TraceListener)
WriteIndent()	Zapisuje wcięcie do odbiornika utworzonego podczas implementowania tej klasy i resetuje NeedIndent właściwość do `false`klasy . (Odziedziczone po TraceListener)
WriteLine(Object)	Zapisuje wartość metody obiektu ToString() w odbiorniku tworzonym podczas implementowania TraceListener klasy, a po niej następuje terminator wiersza. (Odziedziczone po TraceListener)
WriteLine(Object, String)	Zapisuje nazwę kategorii i wartość metody obiektu ToString() do odbiornika tworzonego podczas implementowania TraceListener klasy, a następnie terminator wiersza. (Odziedziczone po TraceListener)
WriteLine(String)	Po przesłonięciu w klasie pochodnej program zapisuje komunikat do odbiornika utworzonego w klasie pochodnej, po którym następuje terminator wiersza.
WriteLine(String, String)	Zapisuje nazwę kategorii i komunikat do odbiornika tworzonego TraceListener podczas implementowania klasy, po którym następuje terminator wiersza. (Odziedziczone po TraceListener)

Dotyczy

Zobacz też

TraceListener

Share via