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

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

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

構文

'宣言
Public Sub New ( _
    writer As TextWriter, _
    name As String _
)
'使用
Dim writer As TextWriter
Dim name As String

Dim instance As New TextWriterTraceListener(writer, name)

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
  新規インスタンスの名前。

例外

使用例

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

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

プラットフォーム

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