TextWriterTraceListener Třída

Definice

Obor názvů:

System.Diagnostics

Sestavení:

netstandard.dll, System.Diagnostics.TextWriterTraceListener.dll

Zdroj:

TextWriterTraceListener.cs

Směruje trasování nebo ladění výstupu TextWriter do nebo do , Streamnapříklad FileStream.

public ref class TextWriterTraceListener : System::Diagnostics::TraceListener

public class TextWriterTraceListener : System.Diagnostics.TraceListener

type TextWriterTraceListener = class
    inherit TraceListener

Public Class TextWriterTraceListener
Inherits TraceListener

Dědičnost

Object

MarshalByRefObject

TraceListener

TextWriterTraceListener

Odvozené

System.Diagnostics.ConsoleTraceListener

System.Diagnostics.DelimitedListTraceListener

System.Diagnostics.EventSchemaTraceListener

System.Diagnostics.XmlWriterTraceListener

Příklady

Následující příklad implementuje instanci TextWriterTraceListener třídy, která používá StreamWriter volána myOutputWriter k zápisu do souboru s názvem TestFile.txt. Nejprve v příkladu vytvoříme soubor pro výstup. Pak vytvoří StreamWriter pro první textový zapisovač, přiřadí ho výstupní soubor a přidá ho Listenersdo souboru . Kód pak do souboru vypíše jeden řádek textu. Příklad nakonec vyprázdní výstupní vyrovnávací paměť.

Po spuštění této ukázky můžete soubor otevřít TestFile.txt a zobrazit výstup.

public class Sample
{

public static int Main(string[] args) {
    // Create a file for output named TestFile.txt.
    Stream myFile = File.Create("TestFile.txt");

    /* Create a new text writer using the output stream, and add it to
     * the trace listeners. */
    TextWriterTraceListener myTextListener = new
       TextWriterTraceListener(myFile);
    Trace.Listeners.Add(myTextListener);

    // Write output to the file.
    Trace.Write("Test output ");

    // Flush the output.
    Trace.Flush();

    return 0;
 }
}

Public Class Sample
    
    Public Shared Sub Main()
        ' Create a file for output named TestFile.txt.
        Dim myFile As Stream = File.Create("TestFile.txt")
        
        ' Create a new text writer using the output stream, and add it to
        ' the trace listeners. 
        Dim myTextListener As New TextWriterTraceListener(myFile)
        Trace.Listeners.Add(myTextListener)

        
        ' Write output to the file.
        Trace.Write("Test output ")
        
        ' Flush the output.
        Trace.Flush() 

        System.Environment.ExitCode = 0
    End Sub

End Class

Poznámky

TextWriterTraceListener Třída poskytuje Writer vlastnost pro získání nebo nastavení zapisovače textu, který přijímá trasování nebo ladění výstupu.

Důležité

Tento typ implementuje rozhraní IDisposable. Jakmile skončíte s používáním typu, měli byste ho odstranit buď přímo, nebo nepřímo. Chcete-li typ odstranit přímo, zavolejte jeho Dispose metodu v bloku try/catch. Pokud ho chcete zlikvidovat nepřímo, použijte konstruktor jazyka, jako je using (v jazyce C#) nebo Using (v jazyce Visual Basic). Další informace naleznete v části Použití objektu, který implementuje IDisposable v IDisposable tématu rozhraní.

Tato třída také poskytuje metody tak CloseWriter , aby již nepřijímá trasování nebo ladění výstup, do Flush výstupní vyrovnávací paměti pro Writer, a zprávy Write do Writer.

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í v aplikaci .NET Framework, 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 naformátovaný 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>

Poznámka:

Pokud se pokusíte zapisovat do souboru, který se používá nebo není k dispozici, název souboru se automaticky předponou identifikátoru GUID.

Konstruktory

Name	Description
TextWriterTraceListener()	Inicializuje novou instanci TextWriterTraceListener třídy jako TextWriter výstupní příjemce.
TextWriterTraceListener(Stream, String)	Inicializuje novou instanci TextWriterTraceListener třídy se zadaným názvem pomocí streamu jako příjemce výstupu ladění a trasování.
TextWriterTraceListener(Stream)	Inicializuje novou instanci TextWriterTraceListener třídy pomocí streamu jako příjemce výstupu ladění a trasování.
TextWriterTraceListener(String, String)	Inicializuje novou instanci TextWriterTraceListener třídy se zadaným názvem pomocí souboru jako příjemce výstupu ladění a trasování.
TextWriterTraceListener(String)	Inicializuje novou instanci TextWriterTraceListener třídy pomocí souboru jako příjemce výstupu ladění a trasování.
TextWriterTraceListener(TextWriter, String)	Inicializuje novou instanci TextWriterTraceListener třídy se zadaným názvem pomocí zadaného zapisovače jako příjemce trasování nebo ladění výstupu.
TextWriterTraceListener(TextWriter)	Inicializuje novou instanci TextWriterTraceListener třídy pomocí zadaného zapisovače jako příjemce trasování nebo ladění výstupu.

Vlastnosti

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

Metody

Name	Description
Close()	Writer Zavře tak, aby přestal přijímat výstup trasování nebo ladění.
Dispose()	Uvolní všechny prostředky používané nástrojem TraceListener. (Zděděno od TraceListener)
Dispose(Boolean)	Odstraní tento TextWriterTraceListener objekt.
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. (Zděděno od TraceListener)
Fail(String)	Vygeneruje chybovou zprávu naslouchacímu procesu, který vytvoříte při implementaci TraceListener třídy. (Zděděno od TraceListener)
Flush()	Vyprázdní výstupní vyrovnávací paměť pro Writer.
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í. (Zděděno od TraceListener)
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. (Zděděno od TraceListener)
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. (Zděděno od TraceListener)
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. (Zděděno od TraceListener)
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. (Zděděno od TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Zapíše informace o trasování a událostech do výstupu specifického pro naslouchací proces. (Zděděno od TraceListener)
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. (Zděděno od TraceListener)
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. (Zděděno od TraceListener)
Write(Object)	Zapíše hodnotu metody objektu ToString() do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy. (Zděděno od TraceListener)
Write(String, String)	Zapíše název kategorie a zprávu do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy. (Zděděno od TraceListener)
Write(String)	Zapíše zprávu do této instance Writer.
WriteIndent()	Zapíše odsazení do naslouchacího procesu, který vytvoříte při implementaci této třídy, a resetuje NeedIndent vlastnost na false. (Zděděno od TraceListener)
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. (Zděděno od TraceListener)
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. (Zděděno od TraceListener)
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. (Zděděno od TraceListener)
WriteLine(String)	Zapíše zprávu do koncového řádku této instance Writer . Výchozí ukončovací znak řádku je návrat na začátek řádku následovaný podáváním (\r\n).

Viz také

• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• EventLogTraceListener
• Stream
• TextWriter
• Debug
• Trace