TraceListener Třída

Definice

Obor názvů:

System.Diagnostics

Sestavení:

netstandard.dll, System.Diagnostics.TraceSource.dll

Zdroj:

TraceListener.cs

abstract Poskytuje základní třídu pro naslouchací procesy, kteří monitorují trasování a ladění výstupu.

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

Dědičnost

Object

MarshalByRefObject

TraceListener

Odvozené

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

Poznámky

Příklady implementace , TraceListenerviz , DefaultTraceListenerTextWriterTraceListenerEventLogTraceListener a třídy.

Pokud chcete použít naslouchací proces trasování, musíte povolit trasování nebo ladění. Následující syntaxe je specifická pro kompilátor. Pokud používáte jiné kompilátory než C# nebo Visual Basic, projděte si dokumentaci pro váš kompilátor.

• Pokud chcete povolit ladění v jazyce C#, přidejte /d:DEBUG příznak do příkazového řádku kompilátoru při kompilaci kódu nebo můžete přidat #define DEBUG na začátek souboru. V jazyce Visual Basic přidejte /d:DEBUG=True příznak do příkazového řádku kompilátoru.

• Pokud chcete povolit trasování v jazyce C#, přidejte /d:TRACE příznak do příkazového řádku kompilátoru při kompilaci kódu nebo přidejte #define TRACE na začátek souboru. V jazyce Visual Basic přidejte /d:TRACE=True příznak do příkazového řádku kompilátoru.

Pokud chcete přidat naslouchací proces trasování, upravte konfigurační soubor, který odpovídá názvu vaší aplikace. V tomto souboru můžete přidat naslouchací proces, nastavit jeho typ a nastavit jeho parametr, odebrat naslouchací proces nebo vymazat všechny naslouchací procesy dříve nastavené aplikací. Konfigurační soubor by měl být formátovaný podobně jako v následujícím příkladu.

<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>

Další informace o použití konfiguračních souborů pro trasování naleznete v tématu <system.diagnostics>.

Poznámky pro implementátory

Dědí z této třídy pro implementaci vlastního naslouchacího procesu pro třídy Debug a Trace třídy. Minimálně je nutné implementovat metody Write(String) a WriteLine(String) metody. Kromě toho můžete implementovat Fail(String)Close() a Flush() metody.

Konstruktory

Name	Description
TraceListener()	Inicializuje novou instanci TraceListener třídy.
TraceListener(String)	Inicializuje novou instanci TraceListener třídy pomocí zadaného názvu jako naslouchací proces.

Vlastnosti

Name	Description
Attributes	Získá vlastní atributy naslouchacího procesu trasování definované v konfiguračním souboru aplikace.
Filter	Získá nebo nastaví filtr trasování pro naslouchací proces trasování.
IndentLevel	Získá nebo nastaví úroveň odsazení.
IndentSize	Získá nebo nastaví počet mezer v odsazení.
IsThreadSafe	Získá hodnotu označující, zda je naslouchací proces trasování bezpečný podproces.
Name	Získá nebo nastaví název pro tento TraceListener.
NeedIndent	Získá nebo nastaví hodnotu označující, zda se má výstup odsadit.
TraceOutputOptions	Získá nebo nastaví možnosti výstupu trasování.

Metody

Name	Description
Close()	Při přepsání v odvozené třídě zavře výstupní datový proud, takže již nepřijímá trasování nebo ladění výstup.
Dispose()	Uvolní všechny prostředky používané nástrojem TraceListener.
Dispose(Boolean)	Uvolní nespravované prostředky používané TraceListener a volitelně uvolní spravované prostředky.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
Fail(String, String)	Vygeneruje chybovou zprávu a podrobnou chybovou zprávu naslouchacímu procesu, který vytvoříte při implementaci TraceListener třídy.
Fail(String)	Vygeneruje chybovou zprávu naslouchacímu procesu, který vytvoříte při implementaci TraceListener třídy.
Flush()	Při přepsání v odvozené třídě vyprázdní výstupní vyrovnávací paměť.
GetHashCode()	Slouží jako výchozí funkce hash. (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é naslouchacím procesem trasování.
GetType()	Získá Type aktuální instance. (Zděděno od Object)
InitializeLifetimeService()	Zastaralé. Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (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)	Zapisuje informace o trasování, datový objekt a informace o událostech do výstupu specifického pro naslouchací proces.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Zapisuje informace o trasování, pole datových objektů a informace o událostech do výstupu specifického pro naslouchací proces.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Zapisuje informace o trasování, formátované pole objektů 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álosti do výstupu specifického pro naslouchací proces.
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Zapíše informace o trasování a událostech do výstupu specifického pro naslouchací proces.
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	Zapisuje informace o trasování, zprávu, související identitu aktivity a informace o událostech do výstupu specifického pro naslouchací proces.
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.
Write(Object)	Zapíše hodnotu metody objektu ToString() do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy.
Write(String, String)	Zapíše název kategorie a zprávu do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy.
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ě.
WriteIndent()	Zapíše odsazení do naslouchacího procesu, který vytvoříte při implementaci této třídy, a resetuje NeedIndent vlastnost na false.
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.
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 řádkem.
WriteLine(String, String)	Zapíše název kategorie a zprávu do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy, následovaný ukončovacím řádkem.
WriteLine(String)	Při přepsání v odvozené třídě napíše zprávu do naslouchacího procesu, který vytvoříte v odvozené třídě, následovaný ukončovacím znakem řádku.

Bezpečný přístup z více vláken

Tento typ je bezpečný pro přístup z více vláken.

Viz také

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