DelimitedListTraceListener クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
トレース出力またはデバッグ出力をストリーム ライターなどのテキスト ライターや、ファイル ストリームなどのストリームに転送します。
public ref class DelimitedListTraceListener : System::Diagnostics::TextWriterTraceListener
public class DelimitedListTraceListener : System.Diagnostics.TextWriterTraceListener
type DelimitedListTraceListener = class
inherit TextWriterTraceListener
Public Class DelimitedListTraceListener
Inherits TextWriterTraceListener
- 継承
- 継承
注釈
トレース出力は、Delimiter プロパティによって指定された区切り記号を使用する、区切られたテキスト形式です。 区切り記号は、出力行の各フィールドを終了するために使用されます。 たとえば、Microsoft Excel スプレッドシートにトレース出力を表示するには、区切り記号としてコンマ (",") を指定し、コンマ区切り値 (CSV) ファイルを作成します。
重要
この型は IDisposable インターフェイスを実装します。 型の使用が完了したら、直接的または間接的に型を破棄する必要があります。 型を直接破棄するには、 ブロックでそのメソッドをtry
/catch
呼び出します。Dispose 間接的に型を破棄するには、using
(C# の場合) または Using
(Visual Basic 言語) などの言語構成要素を使用します。 詳細については、IDisposable インターフェイスに関するトピック内の「IDisposable を実装するオブジェクトの使用」セクションを参照してください。
コードで を DelimitedListTraceListener 作成できます。 または、.NET Framework アプリでのみ、アプリケーション構成ファイルを使用して をDelimitedListTraceListener有効または無効にしてから、アプリケーションで構成された DelimitedListTraceListener を使用することもできます。
注意
はDelimitedListTraceListener、 や Trace.TraceWarningなどのDelimitedListTraceListener.TraceEvent単語Trace
で始まる名前を持つメソッドを使用して出力されるテキストのみを区切ります。 メソッドと 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 が自動的に付けられます。
注意
リスナーは、トレース情報を書き込む、、Trace、および TraceSource クラスの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 プロパティを |
WriteLine(Object) |
TraceListener クラスの実装時に作成したリスナーにオブジェクトの ToString() メソッドの値と行終端記号を書き込みます。 (継承元 TraceListener) |
WriteLine(Object, String) |
TraceListener クラスの実装時に作成したリスナーにカテゴリ名、オブジェクトの ToString() メソッドの値、および行終端記号を書き込みます。 (継承元 TraceListener) |
WriteLine(String) |
このインスタンスの Writer にメッセージを書き込み、続けて行終端記号を書き込みます。 既定の行終端記号は、キャリッジ リターンの次に改行が付いた形です (\r\n)。 (継承元 TextWriterTraceListener) |
WriteLine(String, String) |
TraceListener クラスの実装時に作成したリスナーにカテゴリ名、メッセージ、および行終端記号を書き込みます。 (継承元 TraceListener) |
適用対象
.NET