TraceListenerCollection クラス

.NET Framework クラス ライブラリ リファレンス

TraceListenerCollection クラス

TraceListener オブジェクトのスレッド セーフ リストを提供します。

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

Visual Basic (宣言)

Public Class TraceListenerCollection
    Implements IList, ICollection, IEnumerable

Visual Basic (使用法)

Dim instance As TraceListenerCollection

C#

public class TraceListenerCollection : IList,
 ICollection, IEnumerable

C++

public ref class TraceListenerCollection :
 IList, ICollection, IEnumerable

J#

public class TraceListenerCollection implements
 IList, ICollection, 
    IEnumerable

JScript

public class TraceListenerCollection implements
 IList, ICollection, 
    IEnumerable

解説

TraceListenerCollection リストは、Trace.Listeners コレクションおよび Debug.Listeners コレクションの出力リスナを指定するために使用します。このクラスのインスタンスは作成できません。

このリストはスレッド セーフですが、リストや列挙子にアクセスするためのメソッドは同期ロックを受け取りません。代わりに、コレクションがコピーされ、そのコピーが変更され、コレクションのコピーへの参照が設定されます。Add、Remove、Clear などのメソッドでコレクションの要素を変更します。

TraceListenerCollection クラスは、リストについての情報を含む Count プロパティを提供します。また、このクラスは Contains、GetEnumerator、IndexOf などのメソッドも提供します。

さらに、このクラスはリストを変更するための次のメソッドも提供します。Add、Clear、Insert、およびRemove。CopyTo メソッドは、リストの一部を配列にコピーします。RemoveAt メソッドは、指定したインデックス番号の位置にあるリスト メンバを削除します。

使用例

コンソール画面への書き込みを行う TextWriterTraceListener を作成する例を次に示します。コードは新しいリスナを Trace.Listeners に追加します。

Visual Basic

' Create a ConsoleTraceListener and add it to the trace listeners. 
Dim myWriter As New ConsoleTraceListener()
Trace.Listeners.Add(myWriter)

C#

/* Create a ConsoleTraceListener and add it to the trace listeners. */
ConsoleTraceListener myWriter = new
   ConsoleTraceListener();
Trace.Listeners.Add(myWriter);

C++

/* Create a ConsoletTraceListener and add it to the trace listeners. */
ConsoleTraceListener^ myWriter =
   gcnew ConsoleTraceListener( );
Trace::Listeners->Add( myWriter );

J#

/* Create a ConsoleTraceListener and add it to the trace listeners. 
 */
ConsoleTraceListener myWriter =
    new ConsoleTraceListener();
Trace.get_Listeners().Add(myWriter);

JScript

// Create a listener, which outputs to the console screen, and 
// add it to the trace listeners. 
var myWriter : TextWriterTraceListener = new
 TextWriterTraceListener(System.Console.Out)
Trace.Listeners.Add(myWriter)
Trace.Write("Error output")

継承階層

System.Object
  System.Diagnostics.TraceListenerCollection

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
TraceListenerCollection メンバ
System.Diagnostics 名前空間
TraceListener クラス
DefaultTraceListener クラス
TextWriterTraceListener クラス
ConsoleTraceListener クラス
Debug クラス
Trace クラス