次の方法で共有


TraceListener クラス

トレース出力およびデバッグ出力を監視するリスナの抽象 (Visual Basic では MustInherit) 基本クラスを提供します。

この型のすべてのメンバの一覧については、TraceListener メンバ を参照してください。

System.Object
   System.MarshalByRefObject
      System.Diagnostics.TraceListener
         System.Diagnostics.DefaultTraceListener
         System.Diagnostics.EventLogTraceListener
         System.Diagnostics.TextWriterTraceListener

MustInherit Public Class TraceListener
   Inherits MarshalByRefObject
   Implements IDisposable
[C#]
public abstract class TraceListener : MarshalByRefObject,
   IDisposable
[C++]
public __gc __abstract class TraceListener : public
   MarshalByRefObject, IDisposable
[JScript]
public abstract class TraceListener extends MarshalByRefObject
   implements IDisposable

スレッドセーフ

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

解説

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

スイッチを使用するには、トレースまたはデバッグを有効にする必要があります。次の構文はコンパイラに固有です。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>
    <switches>
        <add name="MagicTraceSwitch" value="3" />
    </switches>
    <trace autoflush="false" indentsize="4">
        <listeners>
           <add name="myListener" type="System.Diagnostics.TextWriterTraceListener" initializeData="c:\myListener.log" />
           <!-- You must supply a valid fully qualified assembly name here. --> 
           <remove type="Assembly text name, Version, Culture, PublicKeyToken"/> 
        </listeners>
    </trace>
</system.diagnostics>
 </configuration>

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

必要条件

名前空間: System.Diagnostics

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

アセンブリ: System (System.dll 内)

参照

TraceListener メンバ | System.Diagnostics 名前空間 | DefaultTraceListener | EventLogTraceListener | TextWriterTraceListener | Debug | Trace