TraceListenerCollection 类

项目
08/17/2007

提供 TraceListener 对象的线程安全列表。

**命名空间:**System.Diagnostics
**程序集:**System（在 system.dll 中）

语法

声明
Public Class TraceListenerCollection
    Implements IList, ICollection, IEnumerable
用法
Dim instance As TraceListenerCollection

public class TraceListenerCollection : IList, ICollection, IEnumerable

public ref class TraceListenerCollection : IList, ICollection, IEnumerable

public class TraceListenerCollection implements IList, ICollection, 
    IEnumerable

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。

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

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

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

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

// 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

线程安全

此类型的任何公共静态（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 类

通过