TraceListener クラス

定義

名前空間:
System.Diagnostics
アセンブリ:
System.dll
アセンブリ:
netstandard.dll

トレースとデバッグの出力を監視するリスナーの abstract 基本クラスを提供します。

public ref class TraceListener abstract : MarshalByRefObject, IDisposable
public abstract class TraceListener : MarshalByRefObject, IDisposable
type TraceListener = class
    inherit MarshalByRefObject
    interface IDisposable
Public MustInherit Class TraceListener
Inherits MarshalByRefObject
Implements IDisposable
継承
Object
MarshalByRefObject
TraceListener
派生
実装
IDisposable

注釈

TraceListenerを実装する方法の例については、DefaultTraceListener、TextWriterTraceListener、およびEventLogTraceListenerクラスを参照してください。

トレース リスナーを使用するには、トレースまたはデバッグを有効にする必要があります。 次の構文はコンパイラ固有です。 C# または Visual Basic 以外のコンパイラを使用する場合は、コンパイラのドキュメントを参照してください。

  • C# でデバッグを有効にするには、コードをコンパイルするときに /d:DEBUG フラグをコンパイラ のコマンド ラインに追加するか、ファイルの先頭に #define DEBUG を追加します。 Visual Basic で、 /d:DEBUG=True フラグをコンパイラ のコマンド ラインに追加します。

  • C# でトレースを有効にするには、コードのコンパイル時に /d:TRACE フラグをコンパイラ コマンド ラインに追加するか、ファイルの先頭に #define TRACE を追加します。 Visual Basic で、 /d:TRACE=True フラグをコンパイラ のコマンド ラインに追加します。

トレース リスナーを追加するには、アプリケーションの名前に対応する構成ファイルを編集します。 このファイル内では、リスナーの追加、その型の設定、パラメーターの設定、リスナーの削除、またはアプリケーションによって以前に設定されたすべてのリスナーのクリアを行うことができます。 構成ファイルの形式は、次の例のようになります。

<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>

トレースに構成ファイルを使用する方法の詳細については、 <system.diagnostics>を参照してください。

注意 (実装者)

このクラスから継承して、 Debug クラスと Trace クラスのカスタム リスナーを実装します。 少なくとも、 Write(String) メソッドと WriteLine(String) メソッドを実装する必要があります。 さらに、 Fail(String)、 Close() 、および Flush() メソッドを実装できます。

コンストラクター

名前 説明
TraceListener()

TraceListener クラスの新しいインスタンスを初期化します。
TraceListener(String)

指定した名前をリスナーとして使用して、 TraceListener クラスの新しいインスタンスを初期化します。

プロパティ

名前 説明
Attributes

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

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

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

インデント内のスペースの数を取得または設定します。
IsThreadSafe

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

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

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

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

メソッド

名前 説明
Close()

派生クラスでオーバーライドされると、出力ストリームを閉じて、トレースまたはデバッグ出力を受信しなくなります。
CreateObjRef(Type)

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

(継承元 MarshalByRefObject)
Dispose()

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

TraceListenerによって使用されるアンマネージ リソースを解放し、必要に応じてマネージド リソースを解放します。
Equals(Object)

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

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

TraceListener クラスを実装するときに作成するリスナーにエラー メッセージと詳細なエラー メッセージを出力します。
Fail(String)

TraceListener クラスを実装するときに作成したリスナーにエラー メッセージを出力します。
Flush()

派生クラスでオーバーライドされると、出力バッファーをフラッシュします。
GetHashCode()

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

(継承元 Object)
GetLifetimeService()

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

(継承元 MarshalByRefObject)
GetSupportedAttributes()

トレース リスナーでサポートされているカスタム属性を取得します。
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, String, Object[])

トレース情報、オブジェクトの書式設定された配列、およびイベント情報をリスナー固有の出力に書き込みます。
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

トレース情報、メッセージ、およびイベント情報をリスナー固有の出力に書き込みます。
TraceEvent(TraceEventCache, String, TraceEventType, Int32)

トレースとイベントの情報をリスナー固有の出力に書き込みます。
TraceTransfer(TraceEventCache, String, Int32, String, Guid)

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

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

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

TraceListener クラスを実装するときに作成するリスナーに、カテゴリ名とメッセージを書き込みます。
Write(String)

派生クラスでオーバーライドされると、指定したメッセージを派生クラスで作成したリスナーに書き込みます。
WriteIndent()

このクラスを実装するときに作成するリスナーにインデントを書き込み、 NeedIndent プロパティを falseにリセットします。
WriteLine(Object, String)

ToString() クラスを実装するときに作成するリスナーに、カテゴリ名とオブジェクトのTraceListener メソッドの値を書き込み、続けて行ターミネータを書き込みます。
WriteLine(Object)

ToString() クラスを実装するときに作成するリスナーに、オブジェクトのTraceListener メソッドの値を書き込み、続けて行終端記号を書き込みます。
WriteLine(String, String)

TraceListener クラスを実装するときに作成するリスナーに、カテゴリ名とメッセージを書き込み、続けて行終端記号を書き込みます。
WriteLine(String)

派生クラスでオーバーライドされると、派生クラスで作成したリスナーにメッセージを書き込み、続けて行ターミネータを書き込みます。

適用対象

スレッド セーフ

この型はスレッド セーフです。

こちらもご覧ください