TraceListenerとは? わかりやすく解説

TraceListener クラス

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

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

Public MustInherit Class
 TraceListener
    Inherits MarshalByRefObject
    Implements IDisposable
Dim instance As TraceListener
public abstract class TraceListener : MarshalByRefObject,
 IDisposable
public ref class TraceListener abstract : public
 MarshalByRefObject, IDisposable
public abstract class TraceListener extends
 MarshalByRefObject implements IDisposable
public abstract class TraceListener extends
 MarshalByRefObject implements IDisposable
解説解説
メモメモ

このクラスに適用される HostProtectionAttribute 属性の Resources プロパティの値は、Synchronization です。HostProtectionAttribute は、デスクトップ アプリケーション (一般的には、アイコンをダブルクリック、コマンドを入力、またはブラウザに URL を入力して起動するアプリケーション) には影響しません。詳細については、HostProtectionAttribute クラスのトピックまたは「SQL Server プログラミングとホスト保護属性」を参照してください。

TraceListener の実装方法を示す例については、DefaultTraceListener、TextWriterTraceListener、EventLogTraceListener の各クラスのトピックを参照してください。

トレース リスナを使用するには、トレースまたはデバッグを有効にする必要があります。次の構文はコンパイラに固有です。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>

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

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

継承階層継承階層
System.Object
   System.MarshalByRefObject
    System.Diagnostics.TraceListener
       Microsoft.VisualBasic.Logging.FileLogTraceListener
       System.Diagnostics.DefaultTraceListener
       System.Diagnostics.EventLogTraceListener
       System.Diagnostics.TextWriterTraceListener
       System.Web.WebPageTraceListener
スレッド セーフスレッド セーフ

この型は、マルチスレッド操作に対して安全です。

プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
TraceListener メンバ
System.Diagnostics 名前空間
DefaultTraceListener クラス
ConsoleTraceListener クラス
EventLogTraceListener クラス
TextWriterTraceListener クラス
Debug クラス
Trace クラス
その他の技術情報
<system.diagnostics> 要素

TraceListener コンストラクタ ()

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

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

protected TraceListener ()
protected:
TraceListener ()
protected TraceListener ()
解説解説

TraceListener のインスタンスの初期プロパティ値を次の表に示します。

プロパティ

既定値

Name

空の文字列 ("")。

Indent

0。

IndentSize

4 個の空白。

プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
TraceListener クラス
TraceListener メンバ
System.Diagnostics 名前空間
TraceListener クラス
DefaultTraceListener クラス
ConsoleTraceListener クラス
EventLogTraceListener クラス
TextWriterTraceListener クラス
Debug クラス
Trace クラス

TraceListener コンストラクタ (String)

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

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

protected TraceListener (
    string name
)
protected:
TraceListener (
    String^ name
)
protected TraceListener (
    String name
)
protected function TraceListener (
    name : String
)

パラメータ

name

TraceListener の名前。

プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
TraceListener クラス
TraceListener メンバ
System.Diagnostics 名前空間
TraceListener クラス
DefaultTraceListener クラス
ConsoleTraceListener クラス
EventLogTraceListener クラス
TextWriterTraceListener クラス
Debug クラス
Trace クラス

TraceListener コンストラクタ

TraceListener クラスの新しいインスタンスを初期化します。
オーバーロードの一覧オーバーロードの一覧

参照参照

関連項目

TraceListener クラス
TraceListener メンバ
System.Diagnostics 名前空間
TraceListener クラス
DefaultTraceListener クラス
ConsoleTraceListener クラス
EventLogTraceListener クラス
TextWriterTraceListener クラス
Debug クラス
Trace クラス

TraceListener プロパティ


TraceListener メソッド


パブリック メソッドパブリック メソッド

( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド Close 派生クラスによってオーバーライドされるときに、出力ストリームを終了して、トレース出力またはデバッグ出力を受信しないようにします。
パブリック メソッド CreateObjRef  リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 ( MarshalByRefObject から継承されます。)
パブリック メソッド Dispose オーバーロードされます。 TraceListener によって使用されているリソースを解放します。
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
パブリック メソッド Fail オーバーロードされます。 TraceListener クラスの実装時に、作成したリスナにエラー メッセージを出力します。
パブリック メソッド Flush 派生クラスによってオーバーライドされるときに、出力バッファをフラッシュします。
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
パブリック メソッド GetLifetimeService  対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 ( Object から継承されます。)
パブリック メソッド InitializeLifetimeService  対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
パブリック メソッド ToString  現在の Object を表す String を返します。 ( Object から継承されます。)
パブリック メソッド TraceData オーバーロードされます。 トレース データをリスナ固有の出力に書き込みます。
パブリック メソッド TraceEvent オーバーロードされます。 トレース情報およびイベント情報をリスナ固有の出力に書き込みます。
パブリック メソッド TraceTransfer トレース情報、メッセージ、関連するアクティビティ ID、およびイベント情報をリスナ固有の出力に書き込みます。
パブリック メソッド Write オーバーロードされます。 TraceListener クラスの実装時に、作成したリスナにメッセージ、カテゴリ名、またはオブジェクトの ToString メソッドの値を書き込みます。
パブリック メソッド WriteLine オーバーロードされます。 TraceListener クラスの実装時に、作成したリスナにメッセージ、カテゴリ名、またはオブジェクトの ToString メソッドの値と行終端記号を書き込みます。
プロテクト メソッドプロテクト メソッド
参照参照

関連項目

TraceListener クラス
System.Diagnostics 名前空間
DefaultTraceListener クラス
ConsoleTraceListener クラス
EventLogTraceListener クラス
TextWriterTraceListener クラス
Debug クラス
Trace クラス

その他の技術情報

<system.diagnostics> 要素

TraceListener メンバ

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

TraceListener データ型で公開されるメンバを以下の表に示します。


プロテクト コンストラクタプロテクト コンストラクタ
パブリック プロパティパブリック プロパティ
プロテクト プロパティプロテクト プロパティ
  名前 説明
プロテクト プロパティ NeedIndent 出力にインデントを設定するかどうかを示す値を取得または設定します。
パブリック メソッドパブリック メソッド
( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド Close 派生クラスによってオーバーライドされるときに、出力ストリームを終了して、トレース出力またはデバッグ出力を受信しないようにします。
パブリック メソッド CreateObjRef  リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (MarshalByRefObject から継承されます。)
パブリック メソッド Dispose オーバーロードされます。 TraceListener によって使用されているリソースを解放します。
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
パブリック メソッド Fail オーバーロードされます。 TraceListener クラスの実装時に、作成したリスナにエラー メッセージを出力します。
パブリック メソッド Flush 派生クラスによってオーバーライドされるときに、出力バッファをフラッシュします。
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
パブリック メソッド GetLifetimeService  対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 (Object から継承されます。)
パブリック メソッド InitializeLifetimeService  対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
パブリック メソッド ToString  現在の Object を表す String を返します。 (Object から継承されます。)
パブリック メソッド TraceData オーバーロードされます。 トレース データをリスナ固有の出力に書き込みます。
パブリック メソッド TraceEvent オーバーロードされます。 トレース情報およびイベント情報をリスナ固有の出力に書き込みます。
パブリック メソッド TraceTransfer トレース情報、メッセージ、関連するアクティビティ ID、およびイベント情報をリスナ固有の出力に書き込みます。
パブリック メソッド Write オーバーロードされます。 TraceListener クラスの実装時に、作成したリスナにメッセージ、カテゴリ名、またはオブジェクトの ToString メソッドの値を書き込みます。
パブリック メソッド WriteLine オーバーロードされます。 TraceListener クラスの実装時に、作成したリスナにメッセージ、カテゴリ名、またはオブジェクトの ToString メソッドの値と行終端記号を書き込みます。
プロテクト メソッドプロテクト メソッド
参照参照

関連項目

TraceListener クラス
System.Diagnostics 名前空間
DefaultTraceListener クラス
ConsoleTraceListener クラス
EventLogTraceListener クラス
TextWriterTraceListener クラス
Debug クラス
Trace クラス

その他の技術情報

<system.diagnostics> 要素



英和和英テキスト翻訳

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

辞書ショートカット

すべての辞書の索引

「TraceListener」の関連用語

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

   

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



TraceListenerのページの著作権

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

©2026 GRAS Group, Inc.RSS