TextWriterTraceListener コンストラクタ ()

.NET Framework クラス ライブラリ リファレンス

TextWriterTraceListener コンストラクタ ()

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

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New TextWriterTraceListener

C#

public TextWriterTraceListener ()

C++

public:
TextWriterTraceListener ()

J#

public TextWriterTraceListener ()

JScript

public function TextWriterTraceListener ()

解説

このコンストラクタは TextWriter ストリームをトレース出力またはデバッグ出力の受信側として使用します。Name は "TextWriter" に初期化されます。

使用例

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

Visual Basic

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

C#

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

}

C++

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

J#

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 

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

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

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

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim fileName As String
Dim name As String

Dim instance As New TextWriterTraceListener(fileName,
 name)

C#

public TextWriterTraceListener (
    string fileName,
    string name
)

C++

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

J#

public TextWriterTraceListener (
    String fileName, 
    String name
)

JScript

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

パラメータ

fileName

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

name

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

例外

例外の種類	条件
ArgumentNullException	ストリームが null 参照 (Visual Basic では Nothing) です。

解説

このコンストラクタは Name プロパティを name パラメータに初期化します。name パラメータが null 参照 (Visual Basic では Nothing) の場合は、空の文字列 ("") が使用されます。

使用例

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

Visual Basic

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

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

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

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim writer As TextWriter
Dim name As String

Dim instance As New TextWriterTraceListener(writer,
 name)

C#

public TextWriterTraceListener (
    TextWriter writer,
    string name
)

C++

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

J#

public TextWriterTraceListener (
    TextWriter writer, 
    String name
)

JScript

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 をフラッシュして終了します。

Visual Basic

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

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

TextWriterTraceListener コンストラクタ (TextWriter)

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

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

Visual Basic (宣言)

Public Sub New ( _
    writer As TextWriter _
)

Visual Basic (使用法)

Dim writer As TextWriter

Dim instance As New TextWriterTraceListener(writer)

C#

public TextWriterTraceListener (
    TextWriter writer
)

C++

public:
TextWriterTraceListener (
    TextWriter^ writer
)

J#

public TextWriterTraceListener (
    TextWriter writer
)

JScript

public function TextWriterTraceListener (
    writer : TextWriter
)

パラメータ

writer

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

例外

例外の種類	条件
ArgumentNullException	ライタが null 参照 (Visual Basic では Nothing) です。

解説

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

使用例

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

Visual Basic

#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

C#

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

C++

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

J#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

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

TextWriterTraceListener コンストラクタ (String)

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

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

Visual Basic (宣言)

Public Sub New ( _
    fileName As String _
)

Visual Basic (使用法)

Dim fileName As String

Dim instance As New TextWriterTraceListener(fileName)

C#

public TextWriterTraceListener (
    string fileName
)

C++

public:
TextWriterTraceListener (
    String^ fileName
)

J#

public TextWriterTraceListener (
    String fileName
)

JScript

public function TextWriterTraceListener (
    fileName : String
)

パラメータ

fileName

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

例外

例外の種類	条件
ArgumentNullException	ファイルが null 参照 (Visual Basic では Nothing) です。

解説

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

使用例

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

Visual Basic

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
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 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim stream As Stream
Dim name As String

Dim instance As New TextWriterTraceListener(stream,
 name)

C#

public TextWriterTraceListener (
    Stream stream,
    string name
)

C++

public:
TextWriterTraceListener (
    Stream^ stream, 
    String^ name
)

J#

public TextWriterTraceListener (
    Stream stream, 
    String name
)

JScript

public function TextWriterTraceListener (
    stream : Stream, 
    name : String
)

パラメータ

stream

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

name

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

例外

例外の種類	条件
ArgumentNullException	ストリームが null 参照 (Visual Basic では Nothing) です。

解説

このコンストラクタは Name プロパティを name パラメータに初期化します。name パラメータが null 参照 (Visual Basic では Nothing) の場合は、空の文字列 ("") が使用されます。

使用例

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

Visual Basic

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

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

TextWriterTraceListener コンストラクタ (Stream)

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

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

Visual Basic (宣言)

Public Sub New ( _
    stream As Stream _
)

Visual Basic (使用法)

Dim stream As Stream

Dim instance As New TextWriterTraceListener(stream)

C#

public TextWriterTraceListener (
    Stream stream
)

C++

public:
TextWriterTraceListener (
    Stream^ stream
)

J#

public TextWriterTraceListener (
    Stream stream
)

JScript

public function TextWriterTraceListener (
    stream : Stream
)

パラメータ

stream

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

例外

例外の種類	条件
ArgumentNullException	ストリームが null 参照 (Visual Basic では Nothing) です。

解説

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

使用例

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

Visual Basic

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

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