TraceListenerCollection クラス

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

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

System.Object
   System.Diagnostics.TraceListenerCollection

Public Class TraceListenerCollection
   Implements IList, ICollection, IEnumerable
[C#]
public class TraceListenerCollection : IList, ICollection,
   IEnumerable
[C++]
public __gc class TraceListenerCollection : public IList,
   ICollection, IEnumerable
[JScript]
public class TraceListenerCollection implements IList, ICollection,
   IEnumerable

スレッドセーフ

この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

解説

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

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

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

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

使用例

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

 
' Create a listener, which outputs to the console screen, and 
' add it to the trace listeners. 
Dim myWriter As New TextWriterTraceListener(System.Console.Out)
Trace.Listeners.Add(myWriter)


[C#] 
/* Create a listener, which outputs to the console screen, and 
  * add it to the trace listeners. */
 TextWriterTraceListener myWriter = new 
    TextWriterTraceListener(System.Console.Out);
 Trace.Listeners.Add(myWriter);


[C++] 
/* Create a listener, which outputs to the console screen, and 
  * add it to the trace listeners. */
 TextWriterTraceListener* myWriter = new 
    TextWriterTraceListener(System::Console::Out);
 Trace::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.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 内)

参照

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