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 の実装方法を示す例については、 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>
<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 メソッドを実装する必要があります。この他、 Fail 、 Close 、 Flush の各メソッドを実装できます。
必要条件
名前空間: 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