DelimitedListTraceListener クラス

定義

トレース出力またはデバッグ出力をストリーム ライターなどのテキスト ライターや、ファイル ストリームなどのストリームに転送します。

public ref class DelimitedListTraceListener : System::Diagnostics::TextWriterTraceListener
public class DelimitedListTraceListener : System.Diagnostics.TextWriterTraceListener
type DelimitedListTraceListener = class
    inherit TextWriterTraceListener
Public Class DelimitedListTraceListener
Inherits TextWriterTraceListener
継承
継承
DelimitedListTraceListener

注釈

トレース出力は、Delimiter プロパティによって指定された区切り記号を使用する、区切られたテキスト形式です。 区切り記号は、出力行の各フィールドを終了するために使用されます。 たとえば、トレース出力をMicrosoft Excelスプレッドシートに表示するには、区切り記号としてコンマ (",") を指定し、コンマ区切り値 (CSV) ファイルを作成します。

重要

この型は IDisposable インターフェイスを実装します。 型の使用が完了したら、直接的または間接的に型を破棄する必要があります。 型を直接破棄するには、ブロック内でその Dispose メソッドをtry/catch 呼び出します。 間接的に型を破棄するには、using (C# の場合) または Using (Visual Basic 言語) などの言語構成要素を使用します。 詳細については、IDisposable インターフェイスに関するトピック内の「IDisposable を実装するオブジェクトの使用」セクションを参照してください。

コードで a を DelimitedListTraceListener 作成できます。 または、.NET Framework アプリでのみ、アプリケーション構成ファイルを使用して a DelimitedListTraceListener を有効または無効にしてから、アプリケーションで構成済DelimitedListTraceListenerみを使用することもできます。

注意

区切り文字は DelimitedListTraceListener 、単語で始まる Trace名前を持つメソッドを使用して出力されるテキストのみを区切ります。次に例を DelimitedListTraceListener.TraceEvent 示します Trace.TraceWarning。 and TextWriterTraceListener.WriteLine メソッドを使用してDebug.Write出力されるトレース データは区切られません。

.NET Framework アプリで構成DelimitedListTraceListenerするには、アプリケーションの名前に対応する構成ファイルを編集します。 このファイルでは、リスナーの追加、リスナーのプロパティの設定、またはリスナーの削除を行うことができます。 構成ファイルは、次の例に示すように書式設定する必要があります。

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <add name="delimitedListener"   
          type="System.Diagnostics.DelimitedListTraceListener"   
          delimiter=","   
          initializeData="delimitedOutput.csv"   
          traceOutputOptions="ProcessId, DateTime" />  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>  

注意

使用中または使用できないファイルに書き込もうとすると、ファイル名の先頭に GUID が自動的に付けられます。

注意

リスナーは、トレース情報を書き込むには、クラスTraceTraceSourceメソッドDebugで使用することを目的としています。 コンストラクターを除くリスナー メソッドは、アプリケーション コードから直接呼び出さないでください。

コンストラクター

DelimitedListTraceListener(Stream)

指定された出力ストリームへの書き込みを行う DelimitedListTraceListener クラスの新しいインスタンスを初期化します。

DelimitedListTraceListener(Stream, String)

指定された出力ストリームへの書き込みを行い、指定された名前を持つ、DelimitedListTraceListener クラスの新しいインスタンスを初期化します。

DelimitedListTraceListener(String)

指定されたファイルへの書き込みを行う DelimitedListTraceListener クラスの新しいインスタンスを初期化します。

DelimitedListTraceListener(String, String)

指定されたファイルへの書き込みを行い、指定された名前を持つ、DelimitedListTraceListener クラスの新しいインスタンスを初期化します。

DelimitedListTraceListener(TextWriter)

指定されたテキスト ライターへの書き込みを行う DelimitedListTraceListener クラスの新しいインスタンスを初期化します。

DelimitedListTraceListener(TextWriter, String)

指定されたテキスト ライターへの書き込みを行い、指定された名前を持つ、DelimitedListTraceListener クラスの新しいインスタンスを初期化します。

プロパティ

Attributes

アプリケーション構成ファイルに定義されているトレース リスナーのカスタム属性を取得します。

(継承元 TraceListener)
Delimiter

区切りリストの区切り記号を取得または設定します。

Filter

トレース リスナーのトレース フィルターを取得または設定します。

(継承元 TraceListener)
IndentLevel

インデント レベルを取得または設定します。

(継承元 TraceListener)
IndentSize

1 つのインデントに含まれるスペースの数を取得または設定します。

(継承元 TraceListener)
IsThreadSafe

トレース リスナーがスレッド セーフかどうかを示す値を取得します。

(継承元 TraceListener)
Name

この TraceListener の名前を取得または設定します。

(継承元 TraceListener)
NeedIndent

出力にインデントを設定するかどうかを示す値を取得または設定します。

(継承元 TraceListener)
TraceOutputOptions

トレース出力オプションを取得または設定します。

(継承元 TraceListener)
Writer

トレース出力またはデバッグ出力を受信するテキスト ライターを取得または設定します。

(継承元 TextWriterTraceListener)

メソッド

Close()

Writer を終了して、トレース出力またはデバッグ出力を受信しないようにします。

(継承元 TextWriterTraceListener)
CreateObjRef(Type)

リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。

(継承元 MarshalByRefObject)
Dispose()

TraceListener によって使用されているすべてのリソースを解放します。

(継承元 TraceListener)
Dispose(Boolean)

この TextWriterTraceListener オブジェクトを破棄します。

(継承元 TextWriterTraceListener)
Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
Fail(String)

TraceListener クラスを実装した場合、作成したリスナーにエラー メッセージを出力します。

(継承元 TraceListener)
Fail(String, String)

TraceListener クラスを実装した場合、作成したリスナーにエラー メッセージと詳細エラー メッセージを出力します。

(継承元 TraceListener)
Flush()

Writer 用の出力バッファーをフラッシュします。

(継承元 TextWriterTraceListener)
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetLifetimeService()
互換性のために残されています。

対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。

(継承元 MarshalByRefObject)
GetSupportedAttributes()

区切り記号を使用するトレース リスナーによってサポートされているカスタム構成ファイル属性を返します。

GetSupportedAttributes()

トレース リスナーによってサポートされるカスタム属性を取得します。

(継承元 TraceListener)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
InitializeLifetimeService()
互換性のために残されています。

このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。

(継承元 MarshalByRefObject)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
MemberwiseClone(Boolean)

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。

(継承元 MarshalByRefObject)
ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

トレース情報、データ オブジェクト、およびイベント情報を出力ファイルまたはストリームに書き込みます。

TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

トレース情報、データ オブジェクトの配列、およびイベント情報を出力ファイルまたはストリームに書き込みます。

TraceEvent(TraceEventCache, String, TraceEventType, Int32)

トレース情報およびイベント情報をリスナー固有の出力に書き込みます。

(継承元 TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

トレース情報、メッセージ、およびイベント情報を出力ファイルまたはストリームに書き込みます。

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

トレース情報、書式設定されたオブジェクトの配列、およびイベント情報を出力ファイルまたはストリームに書き込みます。

TraceTransfer(TraceEventCache, String, Int32, String, Guid)

トレース情報、メッセージ、関連するアクティビティ ID、およびイベント情報をリスナー固有の出力に書き込みます。

(継承元 TraceListener)
Write(Object)

オブジェクトの ToString() メソッドの値を、TraceListener クラスを実装した時に作成したリスナーに書き込みます。

(継承元 TraceListener)
Write(Object, String)

カテゴリ名と、オブジェクトの ToString() メソッドの値を、TraceListener クラスを実装するときに作成したリスナーに書き込みます。

(継承元 TraceListener)
Write(String)

このインスタンスの Writer にメッセージを書き込みます。

(継承元 TextWriterTraceListener)
Write(String, String)

TraceListener クラスを実装した時に作成したリスナーにカテゴリ名とメッセージを書き込みます。

(継承元 TraceListener)
WriteIndent()

このクラスの実装時に作成したリスナーにインデントを書き込み、NeedIndent プロパティを false にリセットします。

(継承元 TraceListener)
WriteLine(Object)

TraceListener クラスの実装時に作成したリスナーにオブジェクトの ToString() メソッドの値と行終端記号を書き込みます。

(継承元 TraceListener)
WriteLine(Object, String)

TraceListener クラスの実装時に作成したリスナーにカテゴリ名、オブジェクトの ToString() メソッドの値、および行終端記号を書き込みます。

(継承元 TraceListener)
WriteLine(String)

このインスタンスの Writer にメッセージを書き込み、続けて行終端記号を書き込みます。 既定の行終端記号は、キャリッジ リターンの次に改行が付いた形です (\r\n)。

(継承元 TextWriterTraceListener)
WriteLine(String, String)

TraceListener クラスの実装時に作成したリスナーにカテゴリ名、メッセージ、および行終端記号を書き込みます。

(継承元 TraceListener)

適用対象