TextWriterTraceListener クラス

定義

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

public class TextWriterTraceListener : System.Diagnostics.TraceListener

type TextWriterTraceListener = class
    inherit TraceListener

Public Class TextWriterTraceListener
Inherits TraceListener

継承

Object

MarshalByRefObject

TraceListener

TextWriterTraceListener

継承

Object

TraceListener

TextWriterTraceListener

派生

System.Diagnostics.ConsoleTraceListener

System.Diagnostics.DelimitedListTraceListener

System.Diagnostics.EventSchemaTraceListener

System.Diagnostics.XmlWriterTraceListener

例

次の例では、TextWriterTraceListener というStreamWriterを使用して myOutputWriter という名前のファイルに書き込むTestFile.txt クラスのインスタンスを実装します。 最初に、出力用のファイルを作成します。 次に、最初のテキスト ライターの StreamWriter を作成し、出力ファイルを割り当てて、 Listenersに追加します。 次に、コードは 1 行のテキストをファイルに出力します。 最後に、出力バッファーをフラッシュします。

このサンプルを実行した後、 TestFile.txt ファイルを開いて出力を確認できます。

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

注釈

TextWriterTraceListener クラスは、トレース出力またはデバッグ出力を受け取るテキスト ライターを取得または設定するWriter プロパティを提供します。

このクラスには、トレースまたはデバッグ出力を受信しなくなったCloseをWriterしたり、Flushの出力バッファーをWriterしたり、メッセージをWriteにWriterしたりするメソッドも用意されています。

トレース リスナーを使用するには、トレースまたはデバッグを有効にする必要があります。 次の構文はコンパイラ固有です。 C# または Visual Basic 以外のコンパイラを使用する場合は、コンパイラのドキュメントを参照してください。

• C# でデバッグを有効にするには、コードをコンパイルするときに /d:DEBUG フラグをコンパイラ のコマンド ラインに追加するか、ファイルの先頭に #define DEBUG を追加します。 Visual Basic で、 /d:DEBUG=True フラグをコンパイラ のコマンド ラインに追加します。

• C# でトレースを有効にするには、コードのコンパイル時に /d:TRACE フラグをコンパイラ コマンド ラインに追加するか、ファイルの先頭に #define TRACE を追加します。 Visual Basic で、 /d:TRACE=True フラグをコンパイラ のコマンド ラインに追加します。

.NET Framework アプリにトレース リスナーを追加するには、アプリケーションの名前に対応する構成ファイルを編集します。 このファイル内では、リスナーの追加、その型の設定、パラメーターの設定、リスナーの削除、またはアプリケーションによって以前に設定されたすべてのリスナーのクリアを行うことができます。 構成ファイルは、次の例のように書式設定する必要があります。

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

こちらもご覧ください

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