TraceListener Třída

Reference

Definice

Obor názvů:: System.Diagnostics

Sestavení:: System.Diagnostics.TraceSource.dll

Sestavení:: System.dll

Sestavení:: netstandard.dll

Zdroj:: TraceListener.cs

Zdroj:: TraceListener.cs

Zdroj:: TraceListener.cs

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

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

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

Dědičnost: Object

MarshalByRefObject
TraceListener

Dědičnost: Object
TraceListener

Odvozené: Microsoft.VisualBasic.Logging.FileLogTraceListener

System.Diagnostics.DefaultTraceListener

System.Diagnostics.Eventing.EventProviderTraceListener

System.Diagnostics.EventLogTraceListener

System.Diagnostics.TextWriterTraceListener

Více…

Implementuje: IDisposable

Poznámky

Příklady implementace TraceListenertřídy najdete v třídách DefaultTraceListenera TextWriterTraceListener EventLogTraceListener .

Pokud chcete používat 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 k kompilátoru.

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 do horní části 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í najdete v tématu <system.diagnostics>.

Poznámky pro implementátory

Dědit z této třídy implementovat vlastní naslouchací proces pro Debug třídy a Trace . Minimálně musíte implementovat Write(String) metody a WriteLine(String) . Kromě toho můžete implementovat Fail(String)metody , Close() a Flush() .

Konstruktory

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

Vlastnosti

Attributes	Získá vlastní atributy trasovacího naslouchacího procesu definované v konfiguračním souboru aplikace.
Filter	Získá nebo nastaví filtr trasování pro trasovací naslouchací proces.
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 trasovací naslouchací proces je bezpečný z více vláken.
Name	Získá nebo nastaví název pro tento TraceListener.
NeedIndent	Získá nebo nastaví hodnotu označující, zda odsadit výstup.
TraceOutputOptions	Získá nebo nastaví možnosti výstupu trasování.

Metody

Close()	Při přepsání v odvozené třídě zavře výstupní datový proud, aby již nepřijíma 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.
Dispose(Boolean)	Uvolní nespravované prostředky používané TraceListener nástrojem a volitelně uvolní spravované prostředky.
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.
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()	Při přepsání v odvozené třídě 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, pole datových objektů a informací 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.
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(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.
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)	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.
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(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.

Platí pro

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

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