Udostępnij za pośrednictwem


TraceListener Klasa

Definicja

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

public ref class TraceListener abstract : MarshalByRefObject, IDisposable
public ref class TraceListener abstract : IDisposable
public abstract class TraceListener : MarshalByRefObject, IDisposable
public abstract class TraceListener : IDisposable
type TraceListener = class
    inherit MarshalByRefObject
    interface IDisposable
type TraceListener = class
    interface IDisposable
Public MustInherit Class TraceListener
Inherits MarshalByRefObject
Implements IDisposable
Public MustInherit Class TraceListener
Implements IDisposable
Dziedziczenie
TraceListener
Dziedziczenie
TraceListener
Pochodne
Implementuje

Uwagi

Aby zapoznać się z przykładami implementowania klasy TraceListener, TextWriterTraceListener zobacz DefaultTraceListenerklasy i EventLogTraceListener .

Aby użyć 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 do góry 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 go do góry 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>.

Uwagi dotyczące implementowania

Dziedzicz z tej klasy, aby zaimplementować odbiornik niestandardowy dla Debug klas i Trace . Co najmniej należy zaimplementować Write(String) metody i WriteLine(String) . Ponadto można zaimplementować Fail(String)metody i Flush() . Close()

Konstruktory

TraceListener()

Inicjuje nowe wystąpienie klasy TraceListener.

TraceListener(String)

Inicjuje TraceListener nowe wystąpienie klasy przy użyciu określonej nazwy jako odbiornika.

Właściwości

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 należy wciąć dane wyjściowe.

TraceOutputOptions

Pobiera lub ustawia opcje danych wyjściowych śledzenia.

Metody

Close()

Gdy zastąpisz klasę pochodną, 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.

Dispose(Boolean)

Zwalnia zasoby niezarządzane używane przez element TraceListener i opcjonalnie zwalnia zasoby zarządzane.

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.

Fail(String, String)

Emituje komunikat o błędzie i szczegółowy komunikat o błędzie do odbiornika utworzonego podczas implementowania TraceListener klasy.

Flush()

Po przesłonięciu w klasie pochodnej opróżni 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 bieżące wystąpienie.

(Odziedziczone po Object)
InitializeLifetimeService()
Przestarzałe.

Uzyskuje obiekt usługi okresu istnienia, aby kontrolować zasady 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 zdarzeniach do danych wyjściowych specyficznych dla 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)

Zapisuje informacje dotyczące śledzenia i zdarzeń do danych wyjściowych specyficznych dla odbiornika.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Zapisuje informacje dotyczące śledzenia, komunikatu i zdarzenia 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 dotyczące śledzenia, komunikatu, powiązanej tożsamości działania i informacji o zdarzeniach do danych wyjściowych specyficznych dla odbiornika.

Write(Object)

Zapisuje wartość metody obiektu ToString() do odbiornika tworzonego podczas implementowania TraceListener klasy.

Write(Object, String)

Zapisuje nazwę kategorii i wartość metody obiektu ToString() do odbiornika tworzonego podczas implementowania TraceListener klasy.

Write(String)

Gdy zastąpisz klasę pochodną, zapisuje określony komunikat do odbiornika utworzonego w klasie pochodnej.

Write(String, String)

Zapisuje nazwę kategorii i komunikat do odbiornika tworzonego podczas implementowania TraceListener klasy.

WriteIndent()

Zapisuje wcięcie do odbiornika utworzonego podczas implementowania tej klasy i resetuje NeedIndent właściwość do false.

WriteLine(Object)

Zapisuje wartość metody obiektu ToString() do odbiornika tworzonego podczas implementowania TraceListener klasy, po której następuje terminator wiersza.

WriteLine(Object, String)

Zapisuje nazwę kategorii i wartość metody obiektu ToString() do odbiornika tworzonego podczas implementowania TraceListener klasy, po której następuje terminator wiersza.

WriteLine(String)

Gdy zastąpisz klasę pochodną, 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 utworzonego podczas implementowania TraceListener klasy, po którym następuje terminator wiersza.

Dotyczy

Bezpieczeństwo wątkowe

Ten typ jest bezpieczny wątkowo.

Zobacz też