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 プロパティ提供します

また、トレース出力またはデバッグ出力受け取らないようにするために WriterClose メソッド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 に追加するコード例次に示します。この例では、この TextWriterTraceListener2 つメッセージ書き込み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 に追加します。この例では、この TextWriterTraceListener2 つメッセージ書き込み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 に追加するコード例次に示します。この例では、この TextWriterTraceListener2 つメッセージ書き込み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 に追加するコード例次に示します。この例では、この TextWriterTraceListener2 つメッセージ書き込み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 に追加するコード例次に示します。この例では、この TextWriterTraceListener2 つメッセージ書き込み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



英和和英テキスト翻訳>> Weblio翻訳
英語⇒日本語日本語⇒英語
  

辞書ショートカット

すべての辞書の索引

「TextWriterTraceListener」の関連用語

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

   

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



TextWriterTraceListenerのページの著作権
Weblio 辞書 情報提供元は 参加元一覧 にて確認できます。

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

©2024 GRAS Group, Inc.RSS