TextWriterTraceListenerとは? わかりやすく解説

TextWriterTraceListener クラス

トレース出力またはデバッグ出力を TextWriter または Stream (FileStream など) に転送します。

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文構文

Public Class TextWriterTraceListener
    Inherits TraceListener
Dim instance As TextWriterTraceListener
public class TextWriterTraceListener : TraceListener
public ref class TextWriterTraceListener :
 public TraceListener
public class TextWriterTraceListener extends
 TraceListener
public class TextWriterTraceListener extends
 TraceListener
解説解説
メモメモ

このクラスに適用される HostProtectionAttribute 属性の Resources プロパティの値は、Synchronization です。HostProtectionAttribute は、デスクトップ アプリケーション (一般的には、アイコンをダブルクリック、コマンドを入力、またはブラウザに URL を入力して起動するアプリケーション) には影響しません。詳細については、HostProtectionAttribute クラスのトピックまたは「SQL Server プログラミングとホスト保護属性」を参照してください。

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

また、トレース出力またはデバッグ出力を受け取らないようにするために Writer を Close メソッド、Writer の出力バッファを Flush メソッド、および Writer へのメッセージを Write メッセージも、このクラスが提供します。

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

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

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

使用中のファイルまたは使用できないファイルへの書き込みを試みた場合、ファイル名にプレフィックスとして GUID が自動的に付けられます。

使用例使用例

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

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

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

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

}
int main()
{
   
   // 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 = gcnew 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 static void 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.get_Listeners().Add(myTextListener);

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

        // Flush the output.
        Trace.Flush();
        return;
    } //main
} //Sample 
継承階層継承階層
System.Object
   System.MarshalByRefObject
     System.Diagnostics.TraceListener
      System.Diagnostics.TextWriterTraceListener
         System.Diagnostics.ConsoleTraceListener
         System.Diagnostics.DelimitedListTraceListener
         System.Diagnostics.XmlWriterTraceListener
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
TextWriterTraceListener メンバ
System.Diagnostics 名前空間
TraceListener
DefaultTraceListener クラス
ConsoleTraceListener クラス
EventLogTraceListener クラス
Stream
TextWriter
Debug クラス
Trace

TextWriterTraceListener コンストラクタ ()

TextWriter を出力の受信者として使用して、TextWriterTraceListener クラスの新しいインスタンスを初期化します。

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文構文

Dim instance As New TextWriterTraceListener
public TextWriterTraceListener ()
public:
TextWriterTraceListener ()
public TextWriterTraceListener ()
public function TextWriterTraceListener ()
解説解説
使用例使用例

TextWriterTraceListener コンストラクタを使用して TextWriterTraceListener を作成するコード例を次に示します。この例では、Writer プロパティをコンソール出力に設定し、TextWriterTraceListener を TraceListenerCollection に追加します。メッセージを 2 つのセグメントに書き込んだ後で、TextWriterTraceListener を閉じます。

Public Class Sample
    
    Public Shared Sub Main()
        ' Create a text writer that writes to the console screen and
 add
        ' it to the trace listeners 
        Dim myWriter As New
 TextWriterTraceListener()
        myWriter.Writer = System.Console.Out
        Trace.Listeners.Add(myWriter)
        
        ' Write the output to the console screen.
        myWriter.Write("Write to the Console screen. ")
        myWriter.WriteLine("Again, write to console screen.")
        
        ' Flush and close the output.
        myWriter.Flush()
        myWriter.Close()
    End Sub

End Class
public class Sample
{

public static void Main(string[]
 args) {
    /* Create a text writer that writes to the console screen and add
     * it to the trace listeners */
    TextWriterTraceListener myWriter = new TextWriterTraceListener();
    myWriter.Writer = System.Console.Out;
    Trace.Listeners.Add(myWriter);
 
    // Write the output to the console screen.
    myWriter.Write("Write to the Console screen. ");
    myWriter.WriteLine("Again, write to console screen.");
 
    // Flush and close the output.
    myWriter.Flush();
    myWriter.Close();
 }

}
int main()
{
   
   /* Create a text writer that writes to the console screen and add
        * it to the trace listeners */
   TextWriterTraceListener^ myWriter = gcnew TextWriterTraceListener;
   myWriter->Writer = System::Console::Out;
   Trace::Listeners->Add( myWriter );
   
   // Write the output to the console screen.
   myWriter->Write( "Write to the Console screen. " );
   myWriter->WriteLine( "Again, write to console screen." );
   
   // Flush and close the output.
   myWriter->Flush();
   myWriter->Close();
}

public class Sample
{
    public static void main(String[]
 args)
    {
        /* Create a text writer that writes to the console screen and add
           it to the trace listeners 
        */
        TextWriterTraceListener myWriter = new TextWriterTraceListener();
        myWriter.set_Writer(System.Console.get_Out());
        Trace.get_Listeners().Add(myWriter);
        // Write the output to the console screen.
        myWriter.Write("Write to the Console screen. ");
        myWriter.WriteLine("Again, write to console screen.");
        // Flush and close the output.
        myWriter.Flush();
        myWriter.Close();
    } //main
} //Sample 
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
TextWriterTraceListener クラス
TextWriterTraceListener メンバ
System.Diagnostics 名前空間
TraceListener
DefaultTraceListener クラス
ConsoleTraceListener クラス
EventLogTraceListener クラス
TextWriterTraceListener クラス
Stream
TextWriter
Debug クラス
Trace

TextWriterTraceListener コンストラクタ (String, String)

ファイルをデバッグ出力およびトレース出力の受信者として使用して、指定した名前で TextWriterTraceListener クラスの新しいインスタンスを初期化します。

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文構文

public TextWriterTraceListener (
    string fileName,
    string name
)
public:
TextWriterTraceListener (
    String^ fileName, 
    String^ name
)
public TextWriterTraceListener (
    String fileName, 
    String name
)
public function TextWriterTraceListener (
    fileName : String, 
    name : String
)

パラメータ

fileName

TextWriterTraceListener が書き込むファイルの名前。

name

新規インスタンスの名前。

例外例外
例外の種類条件

ArgumentNullException

ストリームが null 参照 (Visual Basic では Nothing) です。

解説解説
使用例使用例

TextWriterTraceListener(String,String) コンストラクタを使用して TextWriterTraceListener を作成し、TraceListenerCollection に追加するコード例を次に示します。この例では、この TextWriterTraceListener に 2 つのメッセージを書き込み、TraceListenerCollection 内のすべての TraceListener オブジェクトに 1 つのメッセージを書き込みます。最後に、TextWriterTraceListener をフラッシュして終了します。

Imports System
Imports System.Diagnostics
Imports Microsoft.VisualBasic

Module TWTLConStringNameMod

    Const LISTENER_NAME As String
 = "myStringListener"

    ' args(0) is the specification of the trace log file.
    Sub Main(ByVal args() As
 String)

        ' Verify that a parameter was entered.
        If args.Length = 0 Then
            Console.WriteLine("Enter a trace file specification.")

        Else
            ' Create a TextWriterTraceListener object that takes a 
            ' file specification.
            Dim textListener As TextWriterTraceListener
            Try
                textListener = _
                    New TextWriterTraceListener(args(0), LISTENER_NAME)
                Trace.Listeners.Add(textListener)
            Catch ex As Exception
                Console.WriteLine( _
                    "Error creating TextWriterTraceListener for
 trace " & _
                    "file ""{0}"":"
 & vbCrLf & "{1}", args(0), ex.Message)
                Return
            End Try

            ' Write these messages only to this TextWriterTraceListener.
            textListener.WriteLine( _
                "This is trace listener named """
 & textListener.Name & """")
            textListener.WriteLine("Trace written to a file: "
 & _
                vbCrLf & "    """
 & args(0) & """")

            ' Write a message to all trace listeners.
            Trace.WriteLine(String.Format( _
                "This trace message written {0} to all listeners.",
 Now))

            ' Flush and close the output.
            Trace.Flush()
            textListener.Flush()
            textListener.Close()
        End If
    End Sub
End Module
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
TextWriterTraceListener クラス
TextWriterTraceListener メンバ
System.Diagnostics 名前空間
TraceListener
DefaultTraceListener クラス
ConsoleTraceListener クラス
EventLogTraceListener クラス
TextWriterTraceListener クラス
Stream
TextWriter
Debug クラス
Trace

TextWriterTraceListener コンストラクタ (TextWriter, String)

指定したライタをトレース出力またはデバッグ出力の受信者として使用して、指定した名前で TextWriterTraceListener クラスの新しいインスタンスを初期化します。

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文構文

public TextWriterTraceListener (
    TextWriter writer,
    string name
)
public:
TextWriterTraceListener (
    TextWriter^ writer, 
    String^ name
)
public TextWriterTraceListener (
    TextWriter writer, 
    String name
)
public function TextWriterTraceListener (
    writer : TextWriter, 
    name : String
)

パラメータ

writer

TextWriterTraceListener からの出力を受信する TextWriter。

name

新規インスタンスの名前。

例外例外
例外の種類条件

ArgumentNullException

ライタが null 参照 (Visual Basic では Nothing) です。

使用例使用例

TextWriterTraceListener(TextWriter,String) コンストラクタを使用して TextWriterTraceListener を作成するコード例を次に示します。この例では、StreamWriter,を作成し、次に StreamWriter を参照して TextWriterTraceListener を作成して、これを TraceListenerCollection に追加します。この例では、この TextWriterTraceListener に 2 つのメッセージを書き込み、TraceListenerCollection 内のすべての TraceListener オブジェクトに 1 つのメッセージを書き込みます。最後に、TextWriterTraceListener をフラッシュして終了します。

Imports System
Imports System.Diagnostics
Imports System.IO
Imports Microsoft.VisualBasic

Module TWTLConWriterNameMod

    Const LISTENER_NAME As String
 = "myWriterListener"

    ' args(0) is the specification of the trace log file.
    Sub Main(ByVal args() As
 String)

        ' Verify that a parameter was entered.
        If args.Length = 0 Then
            Console.WriteLine("Enter a trace file specification.")

        Else
            ' Create a StreamWriter object that supports appending.
            Dim traceWriter As StreamWriter
            Try
                traceWriter = New StreamWriter(args(0), True)
            Catch ex As Exception
                Console.WriteLine( _
                    "Error creating StreamWriter for trace file
 ""{0}"":"
 & _
                    vbCrLf & "{1}", args(0), ex.Message)
                Return
            End Try

            ' Create a TextWriterTraceListener that takes a StreamWriter.
            Dim textListener As TextWriterTraceListener
            textListener = _
                New TextWriterTraceListener(traceWriter, LISTENER_NAME)
            Trace.Listeners.Add(textListener)

            ' Write these messages only to this TextWriterTraceListener.
            textListener.WriteLine( _
                "This is trace listener named """
 & textListener.Name & """")
            textListener.WriteLine( _
                "Trace written through a stream to: "
 & _
                vbCrLf & "    """
 & args(0) & """")

            ' Write a message to all trace listeners.
            Trace.WriteLine(String.Format( _
                "This trace message written {0} to all listeners.",
 Now))

            ' Flush and close the output.
            Trace.Flush()
            textListener.Flush()
            textListener.Close()
        End If
    End Sub
End Module
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
TextWriterTraceListener クラス
TextWriterTraceListener メンバ
System.Diagnostics 名前空間
TraceListener
DefaultTraceListener クラス
ConsoleTraceListener クラス
EventLogTraceListener クラス
TextWriterTraceListener クラス
Stream
TextWriter
Debug クラス
Trace

TextWriterTraceListener コンストラクタ (TextWriter)

指定したライタをトレース出力またはデバッグ出力の受信者として使用して、TextWriterTraceListener クラスの新しいインスタンスを初期化します。

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文構文

Dim writer As TextWriter

Dim instance As New TextWriterTraceListener(writer)
public TextWriterTraceListener (
    TextWriter writer
)
public:
TextWriterTraceListener (
    TextWriter^ writer
)
public TextWriterTraceListener (
    TextWriter writer
)
public function TextWriterTraceListener (
    writer : TextWriter
)

パラメータ

writer

TextWriterTraceListener からの出力を受信する TextWriter。

例外例外
例外の種類条件

ArgumentNullException

ライタが null 参照 (Visual Basic では Nothing) です。

解説解説
使用例使用例

TextWriterTraceListener(TextWriter) コンストラクタを使用して TextWriterTraceListener を作成するコード例を次に示します。この例では、StreamWriter,を作成し、次に StreamWriter を参照して TextWriterTraceListener を作成して、これを TraceListenerCollection に追加します。TraceListenerCollection 内のすべての TraceListener オブジェクトにメッセージを書き込み、この TextWriterTraceListener を閉じます。

#Const TRACE=True

Imports System
Imports System.IO
Imports System.Diagnostics

Public Class TextWriterTraceListenerSample
   
   Public Shared Sub Main()
      Dim myTextListener As TextWriterTraceListener
 = Nothing

      ' Create a file for output named TestFile.txt.
      Dim myFileName As String
 = "TestFile.txt"
      Dim myOutputWriter As New
 StreamWriter(myFileName, True)
 
      ' Add a TextWriterTraceListener for the file.
      myTextListener = New TextWriterTraceListener(myOutputWriter)
      Trace.Listeners.Add(myTextListener)
     
      ' Write trace output to all trace listeners.
      Trace.WriteLine(DateTime.Now.ToString() + " - Trace output")
      
      ' Remove and close the file writer/trace listener.
      myTextListener.Flush()
      Trace.Listeners.Remove(myTextListener)
      myTextListener.Close()

   End Sub
End Class
#define TRACE

using System;
using System.IO;
using System.Diagnostics;

public class TextWriterTraceListenerSample
{
    public static void Main()
 
    {
        TextWriterTraceListener myTextListener = null;

        // Create a file for output named TestFile.txt.
        String myFileName = "TestFile.txt";
        StreamWriter myOutputWriter = new StreamWriter(myFileName,
 true);

        // Add a TextWriterTraceListener for the file.
        myTextListener = new TextWriterTraceListener(myOutputWriter);
        Trace.Listeners.Add(myTextListener);
      
 
        // Write trace output to all trace listeners.
        Trace.WriteLine(DateTime.Now.ToString() + " - Trace output");
 
        // Remove and close the file writer/trace listener.
        myTextListener.Flush();
        Trace.Listeners.Remove(myTextListener);
        myTextListener.Close();
    }
}
#using <System.dll>

using namespace System;
using namespace System::IO;
using namespace System::Diagnostics;
int main()
{
   TextWriterTraceListener^ myTextListener = nullptr;
   
   // Create a file for output named TestFile.txt.
   String^ myFileName = "TestFile.txt";
   StreamWriter^ myOutputWriter = gcnew StreamWriter( myFileName,true
 );
   
   // Add a TextWriterTraceListener for the file.
   if ( myOutputWriter )
   {
      myTextListener = gcnew TextWriterTraceListener( myOutputWriter );
      Trace::Listeners->Add( myTextListener );
   }

   
   // Write trace output to all trace listeners.
   Trace::WriteLine( String::Concat( DateTime::Now.ToString(), " - Trace output"
 ) );
   if ( myTextListener )
   {
      
      // Remove and close the file writer/trace listener.
      myTextListener->Flush();
      Trace::Listeners->Remove( myTextListener );
      myTextListener->Close();
   }
}

public static void main(String[]
 args)
{
    // Create a file for output named TestFile.txt.
    String myFileName = "TestFile.txt";
    if (!(File.Exists(myFileName))) {
        Stream myFile = File.Create(myFileName);

        // If the file cannot be created, exit the application.
        if (myFile == null) {
            Console.WriteLine("Could not create file");
            Application.Exit();
        }
    }

    // Assign output file to the output stream.
    StreamWriter myOutputWriter;
    myOutputWriter = File.AppendText(myFileName);

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

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

    // Flush and close the output stream.
    myOutputWriter.Flush();
    myOutputWriter.Close();
} //main
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
TextWriterTraceListener クラス
TextWriterTraceListener メンバ
System.Diagnostics 名前空間
TraceListener
DefaultTraceListener クラス
ConsoleTraceListener クラス
EventLogTraceListener クラス
TextWriterTraceListener クラス
Stream
TextWriter
Debug クラス
Trace

TextWriterTraceListener コンストラクタ (String)

ファイルをデバッグ出力およびトレース出力の受信者として使用して、TextWriterTraceListener クラスの新しいインスタンスを初期化します。

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文構文

Dim fileName As String

Dim instance As New TextWriterTraceListener(fileName)
public TextWriterTraceListener (
    string fileName
)
public:
TextWriterTraceListener (
    String^ fileName
)
public TextWriterTraceListener (
    String fileName
)
public function TextWriterTraceListener (
    fileName : String
)

パラメータ

fileName

TextWriterTraceListener が書き込むファイルの名前。

例外例外
例外の種類条件

ArgumentNullException

ファイルが null 参照 (Visual Basic では Nothing) です。

解説解説
使用例使用例

TextWriterTraceListener(String) コンストラクタを使用して TextWriterTraceListener を作成し、TraceListenerCollection に追加するコード例を次に示します。この例では、この TextWriterTraceListener に 2 つのメッセージを書き込み、TraceListenerCollection 内のすべての TraceListener オブジェクトに 1 つのメッセージを書き込みます。最後に、TextWriterTraceListener をフラッシュして終了します。

Imports System
Imports System.Diagnostics
Imports Microsoft.VisualBasic

Module TWTLConStringMod

    ' args(0) is the specification of the trace log file.
    Sub Main(ByVal args() As
 String)

        ' Verify that a parameter was entered.
        If args.Length = 0 Then
            Console.WriteLine("Enter a trace file specification.")

        Else
            ' Create a TextWriterTraceListener object that takes a 
            ' file specification.
            Dim textListener As TextWriterTraceListener
            Try
                textListener = New TextWriterTraceListener(args(0))
                Trace.Listeners.Add(textListener)
            Catch ex As Exception
                Console.WriteLine( _
                    "Error creating TextWriterTraceListener for
 trace " & _
                    "file ""{0}"":"
 & vbCrLf & "{1}", args(0), ex.Message)
                Return
            End Try

            ' Write these messages only to the TextWriterTraceListener.
            textListener.WriteLine( _
                "This is trace listener named """
 & textListener.Name & """")
            textListener.WriteLine("Trace written to a file: "
 & _
                vbCrLf & "    """
 & args(0) & """")

            ' Write a message to all trace listeners.
            Trace.WriteLine(String.Format( _
                "This trace message written {0} to all listeners.",
 Now))

            ' Flush and close the output.
            Trace.Flush()
            textListener.Flush()
            textListener.Close()
        End If
    End Sub
End Module
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
TextWriterTraceListener クラス
TextWriterTraceListener メンバ
System.Diagnostics 名前空間
TraceListener
DefaultTraceListener クラス
ConsoleTraceListener クラス
EventLogTraceListener クラス
TextWriterTraceListener クラス
Stream
TextWriter
Debug クラス
Trace

TextWriterTraceListener コンストラクタ

TextWriterTraceListener クラスの新しいインスタンスを初期化します。
オーバーロードの一覧オーバーロードの一覧

名前 説明
TextWriterTraceListener () TextWriter を出力の受信者として使用して、TextWriterTraceListener クラスの新しいインスタンスを初期化します。
TextWriterTraceListener (Stream) ストリームをデバッグ出力およびトレース出力の受信者として使用して、TextWriterTraceListener クラスの新しいインスタンスを初期化します。
TextWriterTraceListener (String) ファイルをデバッグ出力およびトレース出力の受信者として使用して、TextWriterTraceListener クラスの新しいインスタンスを初期化します。
TextWriterTraceListener (TextWriter) 指定したライタをトレース出力またはデバッグ出力の受信者として使用して、TextWriterTraceListener クラスの新しいインスタンスを初期化します。
TextWriterTraceListener (Stream, String) ストリームをデバッグ出力およびトレース出力の受信者として使用して、TextWriterTraceListener クラスの新しいインスタンスを初期化します。
TextWriterTraceListener (String, String) ファイルをデバッグ出力およびトレース出力の受信者として使用して、指定した名前で TextWriterTraceListener クラスの新しいインスタンスを初期化します。
TextWriterTraceListener (TextWriter, String) 指定したライタをトレース出力またはデバッグ出力の受信者として使用して、指定した名前で TextWriterTraceListener クラスの新しいインスタンスを初期化します。
参照参照

関連項目

TextWriterTraceListener クラス
TextWriterTraceListener メンバ
System.Diagnostics 名前空間
TraceListener
DefaultTraceListener クラス
ConsoleTraceListener クラス
EventLogTraceListener クラス
TextWriterTraceListener クラス
Stream
TextWriter
Debug クラス
Trace

TextWriterTraceListener コンストラクタ (Stream, String)

ストリームをデバッグ出力およびトレース出力の受信者として使用して、TextWriterTraceListener クラスの新しいインスタンスを初期化します。

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文構文

Dim stream As Stream
Dim name As String

Dim instance As New TextWriterTraceListener(stream,
 name)
public TextWriterTraceListener (
    Stream stream,
    string name
)
public:
TextWriterTraceListener (
    Stream^ stream, 
    String^ name
)
public TextWriterTraceListener (
    Stream stream, 
    String name
)
public function TextWriterTraceListener (
    stream : Stream, 
    name : String
)

パラメータ

stream

TextWriterTraceListener が書き込むストリームを表す Stream。

name

新規インスタンスの名前。

例外例外
例外の種類条件

ArgumentNullException

ストリームが null 参照 (Visual Basic では Nothing) です。

解説解説
使用例使用例

TextWriterTraceListener(Stream,String) コンストラクタを使用して TextWriterTraceListener を作成し、TraceListenerCollection に追加するコード例を次に示します。この例では、この TextWriterTraceListener に 2 つのメッセージを書き込み、TraceListenerCollection 内のすべての TraceListener オブジェクトに 1 つのメッセージを書き込みます。最後に、TextWriterTraceListener をフラッシュして終了します。

Imports System
Imports System.Diagnostics
Imports System.IO
Imports Microsoft.VisualBasic

Module TWTLConStreamNameMod

    Const LISTENER_NAME As String
 = "myStreamListener"

    ' args(0) is the specification of the trace log file.
    Sub Main(ByVal args() As
 String)

        ' Verify that a parameter was entered.
        If args.Length = 0 Then
            Console.WriteLine("Enter a trace file specification.")

        Else
            ' Create a stream object.
            Dim traceStream As FileStream
            Try
                traceStream = New FileStream( _
                    args(0), FileMode.Append, FileAccess.Write)
            Catch ex As Exception
                Console.WriteLine( _
                    "Error creating FileStream for trace file
 ""{0}"":"
 & _
                    vbCrLf & "{1}", args(0), ex.Message)
                Return
            End Try

            ' Create a TextWriterTraceListener object that takes a stream.
            Dim textListener As TextWriterTraceListener
            textListener = _
                New TextWriterTraceListener(traceStream, LISTENER_NAME)
            Trace.Listeners.Add(textListener)

            ' Write these messages only to the TextWriterTraceListener.
            textListener.WriteLine( _
                "This is trace listener named """
 & textListener.Name & """")
            textListener.WriteLine( _
                "Trace written through a stream to: "
 & _
                vbCrLf & "    """
 & args(0) & """")

            ' Write a message to all trace listeners.
            Trace.WriteLine(String.Format( _
                "This trace message written {0} to all listeners.",
 Now))

            ' Flush and close the output.
            Trace.Flush()
            textListener.Flush()
            textListener.Close()
        End If
    End Sub
End Module
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
TextWriterTraceListener クラス
TextWriterTraceListener メンバ
System.Diagnostics 名前空間
TraceListener
DefaultTraceListener クラス
ConsoleTraceListener クラス
EventLogTraceListener クラス
TextWriterTraceListener クラス
Stream
TextWriter
Debug クラス
Trace

TextWriterTraceListener コンストラクタ (Stream)

ストリームをデバッグ出力およびトレース出力の受信者として使用して、TextWriterTraceListener クラスの新しいインスタンスを初期化します。

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文構文

Dim stream As Stream

Dim instance As New TextWriterTraceListener(stream)
public TextWriterTraceListener (
    Stream stream
)
public:
TextWriterTraceListener (
    Stream^ stream
)
public TextWriterTraceListener (
    Stream stream
)
public function TextWriterTraceListener (
    stream : Stream
)

パラメータ

stream

TextWriterTraceListener が書き込むストリームを表す Stream。

例外例外
例外の種類条件

ArgumentNullException

ストリームが null 参照 (Visual Basic では Nothing) です。

解説解説
使用例使用例

TextWriterTraceListener(Stream) コンストラクタを使用して TextWriterTraceListener を作成し、TraceListenerCollection に追加するコード例を次に示します。この例では、この TextWriterTraceListener に 2 つのメッセージを書き込み、TraceListenerCollection 内のすべての TraceListener オブジェクトに 1 つのメッセージを書き込みます。最後に、TextWriterTraceListener をフラッシュして終了します。

Imports System
Imports System.Diagnostics
Imports System.IO
Imports Microsoft.VisualBasic

Module TWTLConStreamMod

    ' args(0) is the specification of the trace log file.
    Sub Main(ByVal args() As
 String)

        ' Verify that a parameter was entered.
        If args.Length = 0 Then
            Console.WriteLine("Enter a trace file specification.")

        Else
            ' Create a stream object.
            Dim traceStream As FileStream
            Try
                traceStream = New FileStream( _
                    args(0), FileMode.Append, FileAccess.Write)
            Catch ex As Exception
                Console.WriteLine( _
                    "Error creating FileStream for trace file
 ""{0}"":"
 & _
                    vbCrLf & "{1}", args(0), ex.Message)
                Return
            End Try

            ' Create a TextWriterTraceListener object that takes a stream.
            Dim textListener As TextWriterTraceListener
            textListener = New TextWriterTraceListener(traceStream)
            Trace.Listeners.Add(textListener)

            ' Write these messages only to this TextWriterTraceListener.
            textListener.WriteLine( _
                "This is trace listener named """
 & textListener.Name & """")
            textListener.WriteLine( _
                "Trace written through a stream to: "
 & _
                vbCrLf & "    """
 & args(0) & """")

            ' Write a message to all trace listeners.
            Trace.WriteLine(String.Format( _
                "This trace message written {0} to all listeners.",
 Now))

            ' Flush and close the output.
            Trace.Flush()
            textListener.Flush()
            textListener.Close()
        End If
    End Sub
End Module
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
TextWriterTraceListener クラス
TextWriterTraceListener メンバ
System.Diagnostics 名前空間
TraceListener
DefaultTraceListener クラス
ConsoleTraceListener クラス
EventLogTraceListener クラス
TextWriterTraceListener クラス
Stream
TextWriter
Debug クラス
Trace

TextWriterTraceListener プロパティ


パブリック プロパティパブリック プロパティ

プロテクト プロパティプロテクト プロパティ
  名前 説明
プロテクト プロパティ NeedIndent  出力にインデントを設定するかどうかを示す値を取得または設定します。 ( TraceListener から継承されます。)
参照参照

関連項目

TextWriterTraceListener クラス
System.Diagnostics 名前空間
TraceListener
DefaultTraceListener クラス
ConsoleTraceListener クラス
EventLogTraceListener クラス
Stream
TextWriter
Debug クラス
Trace

TextWriterTraceListener メソッド


パブリック メソッドパブリック メソッド

( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド Close オーバーライドされます。 Writer を終了して、トレース出力またはデバッグ出力を受信しないようにします。
パブリック メソッド CreateObjRef  リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 ( MarshalByRefObject から継承されます。)
パブリック メソッド Dispose オーバーロードされます。 この TextWriterTraceListener オブジェクトを破棄します。
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
パブリック メソッド Fail  オーバーロードされます。 TraceListener クラスの実装時に、作成したリスナにエラー メッセージを出力します。 ( TraceListener から継承されます。)
パブリック メソッド Flush オーバーライドされます。 Writer 用の出力バッファをフラッシュします。
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
パブリック メソッド GetLifetimeService  対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 ( Object から継承されます。)
パブリック メソッド InitializeLifetimeService  対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
パブリック メソッド ToString  現在の Object を表す String を返します。 ( Object から継承されます。)
パブリック メソッド TraceData  オーバーロードされます。 トレース データをリスナ固有の出力に書き込みます。 ( TraceListener から継承されます。)
パブリック メソッド TraceEvent  オーバーロードされます。 トレース情報およびイベント情報をリスナ固有の出力に書き込みます。 ( TraceListener から継承されます。)
パブリック メソッド TraceTransfer  トレース情報、メッセージ、関連するアクティビティ ID、およびイベント情報をリスナ固有の出力に書き込みます。 ( TraceListener から継承されます。)
パブリック メソッド Write オーバーロードされます。 このインスタンスの Writer にメッセージを書き込みます。
パブリック メソッド WriteLine オーバーロードされます。 このインスタンスの Writer にメッセージを書き込み、続けて行終端記号を書き込みます。
プロテクト メソッドプロテクト メソッド
参照参照

関連項目

TextWriterTraceListener クラス
System.Diagnostics 名前空間
TraceListener
DefaultTraceListener クラス
ConsoleTraceListener クラス
EventLogTraceListener クラス
Stream
TextWriter
Debug クラス
Trace

TextWriterTraceListener メンバ

トレース出力またはデバッグ出力を TextWriter または Stream (FileStream など) に転送します。

TextWriterTraceListener データ型で公開されるメンバを以下の表に示します。


パブリック コンストラクタパブリック コンストラクタ
  名前 説明
パブリック メソッド TextWriterTraceListener オーバーロードされます。 TextWriterTraceListener クラスの新しいインスタンスを初期化します。
パブリック プロパティパブリック プロパティ
プロテクト プロパティプロテクト プロパティ
  名前 説明
プロテクト プロパティ NeedIndent  出力にインデントを設定するかどうかを示す値を取得または設定します。(TraceListener から継承されます。)
パブリック メソッドパブリック メソッド
( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド Close オーバーライドされます。 Writer を終了して、トレース出力またはデバッグ出力を受信しないようにします。
パブリック メソッド CreateObjRef  リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (MarshalByRefObject から継承されます。)
パブリック メソッド Dispose オーバーロードされます。 この TextWriterTraceListener オブジェクトを破棄します。
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
パブリック メソッド Fail  オーバーロードされます。 TraceListener クラスの実装時に、作成したリスナにエラー メッセージを出力します。 (TraceListener から継承されます。)
パブリック メソッド Flush オーバーライドされます。 Writer 用の出力バッファをフラッシュします。
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
パブリック メソッド GetLifetimeService  対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 (Object から継承されます。)
パブリック メソッド InitializeLifetimeService  対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
パブリック メソッド ToString  現在の Object を表す String を返します。 (Object から継承されます。)
パブリック メソッド TraceData  オーバーロードされます。 トレース データをリスナ固有の出力に書き込みます。 (TraceListener から継承されます。)
パブリック メソッド TraceEvent  オーバーロードされます。 トレース情報およびイベント情報をリスナ固有の出力に書き込みます。 (TraceListener から継承されます。)
パブリック メソッド TraceTransfer  トレース情報、メッセージ、関連するアクティビティ ID、およびイベント情報をリスナ固有の出力に書き込みます。 (TraceListener から継承されます。)
パブリック メソッド Write オーバーロードされます。 このインスタンスの Writer にメッセージを書き込みます。
パブリック メソッド WriteLine オーバーロードされます。 このインスタンスの Writer にメッセージを書き込み、続けて行終端記号を書き込みます。
プロテクト メソッドプロテクト メソッド
参照参照

関連項目

TextWriterTraceListener クラス
System.Diagnostics 名前空間
TraceListener
DefaultTraceListener クラス
ConsoleTraceListener クラス
EventLogTraceListener クラス
Stream
TextWriter
Debug クラス
Trace



英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

すべての辞書の索引

「TextWriterTraceListener」の関連用語

TextWriterTraceListenerのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



TextWriterTraceListenerのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS