TextWriterTraceListener コンストラクター

定義

名前空間:

System.Diagnostics

アセンブリ:

System.Diagnostics.TextWriterTraceListener.dll

TextWriterTraceListener クラスの新しいインスタンスを初期化します。

オーバーロード

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

TextWriterTraceListener()

ソース:

TextWriterTraceListener.cs

TextWriter を出力宛先として TextWriterTraceListener クラスの新しいインスタンスを初期化します。

public:
 TextWriterTraceListener();

public TextWriterTraceListener ();

Public Sub New ()

例

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

void main()
{
   #if defined(TRACE)
   // 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();
   #endif
}

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

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

注釈

このコンストラクターは、 TextWriter トレースまたはデバッグ出力の受信者としてストリームを使用します。 その Name プロパティは、空の文字列 (""、または String.Empty) に初期化されます。

こちらもご覧ください

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

TextWriterTraceListener(Stream)

ソース:

TextWriterTraceListener.cs

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

public:
 TextWriterTraceListener(System::IO::Stream ^ stream);

public TextWriterTraceListener (System.IO.Stream stream);

new System.Diagnostics.TextWriterTraceListener : System.IO.Stream -> System.Diagnostics.TextWriterTraceListener

Public Sub New (stream As Stream)

パラメーター

stream

Stream

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

例外

ArgumentNullException

ストリームが null です。

例

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

using System;
using System.Diagnostics;
using System.IO;
using Microsoft.VisualBasic;

class TWTLConStreamMod
{

    // args(0) is the specification of the trace log file.
    public static void Main(string[] args)
    {

        // Verify that a parameter was entered.
        if (args.Length==0)
        {
            Console.WriteLine("Enter a trace file specification.");
        }
        else
        {
            // Create a stream object.
            FileStream traceStream;
            try
            {
                traceStream = new FileStream(args[0], FileMode.Append, FileAccess.Write);
            }
            catch(Exception ex)
            {
                Console.WriteLine("Error creating FileStream for trace file \"{0}\":" +
                    "\r\n{1}", args[0], ex.Message);
                return;
            }

            // Create a TextWriterTraceListener object that takes a stream.
            TextWriterTraceListener textListener;
            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: " +
                "\r\n    \""+args[0]+"\"");

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

            // Flush and close the output.
            Trace.Flush();
            textListener.Flush();
            textListener.Close();
        }
    }
}

Imports System.Diagnostics
Imports System.IO

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

注釈

このコンストラクターは、 プロパティを Name 空の文字列 ("") に初期化します。

こちらもご覧ください

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

TextWriterTraceListener(TextWriter)

ソース:

TextWriterTraceListener.cs

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

public:
 TextWriterTraceListener(System::IO::TextWriter ^ writer);

public TextWriterTraceListener (System.IO.TextWriter writer);

new System.Diagnostics.TextWriterTraceListener : System.IO.TextWriter -> System.Diagnostics.TextWriterTraceListener

Public Sub New (writer As TextWriter)

パラメーター

writer

TextWriter

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

例外

ArgumentNullException

ライターが null です。

例

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

#using <System.dll>
using namespace System;
using namespace System::IO;
using namespace System::Diagnostics;

void main()
{
   #if defined(TRACE)
   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();
   }
   #endif
}

#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();
    }
}

#Const TRACE=True

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

注釈

このコンストラクターは、 プロパティを Name 空の文字列 ("") に初期化します。

こちらもご覧ください

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

TextWriterTraceListener(String)

ソース:

TextWriterTraceListener.cs

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

public:
 TextWriterTraceListener(System::String ^ fileName);

public TextWriterTraceListener (string? fileName);

new System.Diagnostics.TextWriterTraceListener : string -> System.Diagnostics.TextWriterTraceListener

Public Sub New (fileName As String)

パラメーター

fileName

String

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

例外

ArgumentNullException

ファイルが null です。

例

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

using System;
using System.Diagnostics;
using Microsoft.VisualBasic;

class TWTLConStringMod
{

    // args(0) is the specification of the trace log file.
    public static void Main(string[] args)
    {

        // Verify that a parameter was entered.
        if (args.Length==0)
        {
            Console.WriteLine("Enter a trace file specification.");
        }
        else
        {
            // Create a TextWriterTraceListener object that takes a
            // file specification.
            TextWriterTraceListener textListener;
            try
            {
                textListener = new TextWriterTraceListener(args[0]);
                Trace.Listeners.Add(textListener);
            }
            catch(Exception ex)
            {
                Console.WriteLine("Error creating TextWriterTraceListener for trace " +
                    "file \"{0}\":\r\n{1}", args[0], ex.Message);
                return;
            }

            // Write these messages only to the TextWriterTraceListener.
            textListener.WriteLine("This is trace listener named \""+textListener.Name+"\"");
            textListener.WriteLine("Trace written to a file: " +
                "\r\n    \""+args[0]+"\"");

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

            // Flush and close the output.
            Trace.Flush();
            textListener.Flush();
            textListener.Close();
        }
    }
}

Imports System.Diagnostics

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

注釈

このコンストラクターは、 プロパティを Name 空の文字列 ("") に初期化します。

こちらもご覧ください

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

TextWriterTraceListener(Stream, String)

ソース:

TextWriterTraceListener.cs

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

public:
 TextWriterTraceListener(System::IO::Stream ^ stream, System::String ^ name);

public TextWriterTraceListener (System.IO.Stream stream, string? name);

new System.Diagnostics.TextWriterTraceListener : System.IO.Stream * string -> System.Diagnostics.TextWriterTraceListener

Public Sub New (stream As Stream, name As String)

パラメーター

stream

Stream

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

name

String

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

例外

ArgumentNullException

ストリームが null です。

例

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

using System;
using System.Diagnostics;
using System.IO;
using Microsoft.VisualBasic;

class TWTLConStreamNameMod
{

    const string LISTENER_NAME = "myStreamListener";

    // args(0) is the specification of the trace log file.
    public static void Main(string[] args)
    {

        // Verify that a parameter was entered.
        if (args.Length==0)
        {
            Console.WriteLine("Enter a trace file specification.");
        }
        else
        {
            // Create a stream object.
            FileStream traceStream;
            try
            {
                traceStream = new FileStream(args[0], FileMode.Append, FileAccess.Write);
            }
            catch(Exception ex)
            {
                Console.WriteLine("Error creating FileStream for trace file \"{0}\":" +
                    "\r\n{1}", args[0], ex.Message);
                return;
            }

            // Create a TextWriterTraceListener object that takes a stream.
            TextWriterTraceListener textListener;
            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: " +
                "\r\n    \""+args[0]+"\"");

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

            // Flush and close the output.
            Trace.Flush();
            textListener.Flush();
            textListener.Close();
        }
    }
}

Imports System.Diagnostics
Imports System.IO

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

注釈

このコンストラクターは、 パラメーターが の Name 場合は name 、パラメーターまたは空の文字列 ("") にプロパティを name 初期化します null。

こちらもご覧ください

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

TextWriterTraceListener(TextWriter, String)

ソース:

TextWriterTraceListener.cs

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

public:
 TextWriterTraceListener(System::IO::TextWriter ^ writer, System::String ^ name);

public TextWriterTraceListener (System.IO.TextWriter writer, string? name);

new System.Diagnostics.TextWriterTraceListener : System.IO.TextWriter * string -> System.Diagnostics.TextWriterTraceListener

Public Sub New (writer As TextWriter, name As String)

パラメーター

writer

TextWriter

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

name

String

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

例外

ArgumentNullException

ライターが null です。

例

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

using System;
using System.Diagnostics;
using System.IO;
using Microsoft.VisualBasic;

class TWTLConWriterNameMod
{

    const string LISTENER_NAME = "myWriterListener";

    // args(0) is the specification of the trace log file.
    public static void Main(string[] args)
    {

        // Verify that a parameter was entered.
        if (args.Length==0)
        {
            Console.WriteLine("Enter a trace file specification.");
        }
        else
        {
            // Create a StreamWriter object that supports appending.
            StreamWriter traceWriter;
            try
            {
                traceWriter = new StreamWriter(args[0], true);
            }
            catch(Exception ex)
            {
                Console.WriteLine("Error creating StreamWriter for trace file \"{0}\":" +
                    "\r\n{1}", args[0], ex.Message);
                return;
            }

            // Create a TextWriterTraceListener that takes a StreamWriter.
            TextWriterTraceListener textListener;
            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: " +
                "\r\n    \""+args[0]+"\"");

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

            // Flush and close the output.
            Trace.Flush();
            textListener.Flush();
            textListener.Close();
        }
    }
}

Imports System.Diagnostics
Imports System.IO

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

こちらもご覧ください

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

TextWriterTraceListener(String, String)

ソース:

TextWriterTraceListener.cs

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

public:
 TextWriterTraceListener(System::String ^ fileName, System::String ^ name);

public TextWriterTraceListener (string? fileName, string? name);

new System.Diagnostics.TextWriterTraceListener : string * string -> System.Diagnostics.TextWriterTraceListener

Public Sub New (fileName As String, name As String)

パラメーター

fileName

String

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

name

String

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

例外

ArgumentNullException

ストリームが null です。

例

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

using System;
using System.Diagnostics;
using Microsoft.VisualBasic;

class TWTLConStringNameMod
{

    const string LISTENER_NAME = "myStringListener";

    // args(0) is the specification of the trace log file.
    public static void Main(string[] args)
    {

        // Verify that a parameter was entered.
        if (args.Length==0)
        {
            Console.WriteLine("Enter a trace file specification.");
        }
        else
        {
            // Create a TextWriterTraceListener object that takes a
            // file specification.
            TextWriterTraceListener textListener;
            try
            {
                textListener = new TextWriterTraceListener(args[0], LISTENER_NAME);
                Trace.Listeners.Add(textListener);
            }
            catch(Exception ex)
            {
                Console.WriteLine("Error creating TextWriterTraceListener for trace " +
                    "file \"{0}\":\r\n{1}", args[0], ex.Message);
                return;
            }

            // Write these messages only to this TextWriterTraceListener.
            textListener.WriteLine("This is trace listener named \""+textListener.Name+"\"");
            textListener.WriteLine("Trace written to a file: " +
                "\r\n    \""+args[0]+"\"");

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

            // Flush and close the output.
            Trace.Flush();
            textListener.Flush();
            textListener.Close();
        }
    }
}

Imports System.Diagnostics

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

注釈

このコンストラクターは、 パラメーターが の Name 場合は name 、パラメーターまたは空の文字列 ("") にプロパティを name 初期化します null。

こちらもご覧ください

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