TraceListener Klasa

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestawy:

netstandard.dll, System.Diagnostics.TraceSource.dll

Źródło:

TraceListener.cs

Udostępnia klasę bazową abstract dla odbiorników, którzy monitorują dane wyjściowe śledzenia i debugowania.

public ref class TraceListener abstract : MarshalByRefObject, IDisposable

public abstract class TraceListener : MarshalByRefObject, IDisposable

type TraceListener = class
    inherit MarshalByRefObject
    interface IDisposable

Public MustInherit Class TraceListener
Inherits MarshalByRefObject
Implements IDisposable

Dziedziczenie

Object

MarshalByRefObject

TraceListener

Pochodne

Microsoft.VisualBasic.Logging.FileLogTraceListener

System.Diagnostics.DefaultTraceListener

System.Diagnostics.Eventing.EventProviderTraceListener

System.Diagnostics.EventLogTraceListener

System.Diagnostics.TextWriterTraceListener

System.Web.IisTraceListener

System.Web.WebPageTraceListener

Implementuje

IDisposable

Uwagi

Przykłady implementacji klasy TraceListener, można znaleźć w DefaultTraceListenerTextWriterTraceListener temacie i .EventLogTraceListener

Aby używać odbiornika śledzenia, należy włączyć śledzenie lub debugowanie. Następująca składnia jest specyficzna dla kompilatora. Jeśli używasz kompilatorów innych niż C# lub Visual Basic, zapoznaj się z dokumentacją kompilatora.

• Aby włączyć debugowanie w języku C#, dodaj flagę /d:DEBUG do wiersza polecenia kompilatora podczas kompilowania kodu lub możesz dodać #define DEBUG go na początku pliku. W języku Visual Basic dodaj flagę /d:DEBUG=True do wiersza polecenia kompilatora.

• Aby włączyć śledzenie w języku C#, dodaj flagę /d:TRACE do wiersza polecenia kompilatora podczas kompilowania kodu lub dodaj #define TRACE ją na początku pliku. W języku Visual Basic dodaj flagę /d:TRACE=True do wiersza polecenia kompilatora.

Aby dodać odbiornik śledzenia, zmodyfikuj plik konfiguracji odpowiadający nazwie aplikacji. W tym pliku można dodać odbiornik, ustawić jego typ i ustawić jego parametr, usunąć odbiornik lub wyczyścić wszystkie odbiorniki ustawione wcześniej przez aplikację. Plik konfiguracji powinien być sformatowany podobnie jak w poniższym przykładzie.

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="4">
      <listeners>
        <add name="myListener" type="System.Diagnostics.TextWriterTraceListener" initializeData="TextWriterOutput.log" />
        <remove name="Default" />
      </listeners>
    </trace>
  </system.diagnostics>
</configuration>

Aby uzyskać więcej informacji na temat używania plików konfiguracji do śledzenia, zobacz <system.diagnostics>.

Notatki dotyczące implementowania

Dziedziczenie z tej klasy w celu zaimplementowania niestandardowego odbiornika Debug dla klas i Trace . Co najmniej należy zaimplementować Write(String) metody i WriteLine(String) . Ponadto można zaimplementować Fail(String)metody i Close() . Flush()

Konstruktory

Nazwa	Opis
TraceListener()	Inicjuje nowe wystąpienie klasy TraceListener.
TraceListener(String)	Inicjuje nowe wystąpienie TraceListener klasy przy użyciu określonej nazwy jako odbiornika.

Właściwości

Nazwa	Opis
Attributes	Pobiera niestandardowe atrybuty odbiornika śledzenia zdefiniowane w pliku konfiguracji aplikacji.
Filter	Pobiera lub ustawia filtr śledzenia dla odbiornika śledzenia.
IndentLevel	Pobiera lub ustawia poziom wcięcia.
IndentSize	Pobiera lub ustawia liczbę spacji w wcięcie.
IsThreadSafe	Pobiera wartość wskazującą, czy odbiornik śledzenia jest bezpieczny wątkiem.
Name	Pobiera lub ustawia nazwę dla tego elementu TraceListener.
NeedIndent	Pobiera lub ustawia wartość wskazującą, czy ma być wcięcie danych wyjściowych.
TraceOutputOptions	Pobiera lub ustawia opcje danych wyjściowych śledzenia.

Metody

Nazwa	Opis
Close()	Gdy przesłonięta w klasie pochodnej, zamyka strumień wyjściowy, aby nie odbierał już danych wyjściowych śledzenia ani debugowania.
Dispose()	Zwalnia wszystkie zasoby używane przez program TraceListener.
Dispose(Boolean)	Zwalnia niezarządzane zasoby używane przez TraceListener program i opcjonalnie zwalnia zarządzane zasoby.
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
Fail(String, String)	Emituje komunikat o błędzie i szczegółowy komunikat o błędzie do odbiornika utworzonego TraceListener podczas implementowania klasy.
Fail(String)	Emituje komunikat o błędzie do odbiornika utworzonego podczas implementowania TraceListener klasy.
Flush()	Po zastąpieniu w klasie pochodnej 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()	Pobiera Type 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 Object. (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 określonych danych wyjściowych odbiornika.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Zapisuje informacje śledzenia, tablicę obiektów danych i informacje o zdarzeniach 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.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Zapisuje informacje śledzenia, komunikat i informacje o zdarzeniu do określonych danych wyjściowych odbiornika.
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Zapisuje informacje o śledzeniu i zdarzeniu do określonych danych wyjściowych 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, String)	Zapisuje nazwę kategorii i wartość metody obiektu ToString() do odbiornika tworzonego podczas implementowania TraceListener klasy.
Write(Object)	Zapisuje wartość metody obiektu ToString() w odbiorniku tworzonym podczas implementowania TraceListener klasy .
Write(String, String)	Zapisuje nazwę kategorii i komunikat do odbiornika utworzonego podczas implementowania TraceListener klasy.
Write(String)	Po zastąpieniu w klasie pochodnej zapisuje określony komunikat do odbiornika utworzonego w klasie pochodnej.
WriteIndent()	Zapisuje wcięcie do odbiornika utworzonego podczas implementowania tej klasy i resetuje NeedIndent właściwość do falseklasy .
WriteLine(Object, String)	Zapisuje nazwę kategorii i wartość metody obiektu ToString() do odbiornika utworzonego podczas implementowania TraceListener klasy, a następnie terminator wiersza.
WriteLine(Object)	Zapisuje wartość metody obiektu ToString() do odbiornika utworzonego podczas implementowania TraceListener klasy, a następnie terminator wiersza.
WriteLine(String, String)	Zapisuje nazwę kategorii i komunikat do odbiornika utworzonego TraceListener podczas implementowania klasy, po którym następuje terminator wiersza.
WriteLine(String)	Gdy przesłonięta w klasie pochodnej, zapisuje komunikat do odbiornika utworzonego w klasie pochodnej, po którym następuje terminator wiersza.

Bezpieczeństwo wątkowe

Ten typ jest bezpieczny wątkiem.

Zobacz też

• DefaultTraceListener
• ConsoleTraceListener
• EventLogTraceListener
• TextWriterTraceListener
• Debug
• Trace
• <system.diagnostics> , element