TraceListenerCollection 类

定义

命名空间:

System.Diagnostics

程序集:

System.Diagnostics.TraceSource.dll

Source:

TraceListeners.cs

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

public ref class TraceListenerCollection : System::Collections::IList

public class TraceListenerCollection : System.Collections.IList

type TraceListenerCollection = class
    interface ICollection
    interface IEnumerable
    interface IList

Public Class TraceListenerCollection
Implements IList

继承

Object

TraceListenerCollection

实现

ICollection IEnumerable IList

示例

以下示例创建写入 ConsoleTraceListener 控制台屏幕的 。 然后，代码将新的侦听器添加到 Trace.Listeners。

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

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

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

注解

列表TraceListenerCollection用于指定 和 集合的Debug.Listeners输出侦听器Trace.Listeners。 无法创建此类的实例。

此列表是线程安全的，但用于访问列表和枚举器的方法不采用同步锁。 相反，复制集合，修改副本，并将引用设置为集合的副本。 、 Remove和 Clear 等Add方法修改集合中的元素。

类 TraceListenerCollection 为有关列表的信息提供 Count 属性。 它还提供以下方法：Contains、、GetEnumeratorIndexOf。

此类还提供以下方法来修改列表： Add、 Clear、 Insert和 Remove。 方法 CopyTo 将列表的一部分复制到数组。 方法 RemoveAt 删除指定索引号处的列表成员。

属性

Count	获取列表中的侦听器数。
Item[Int32]	获取或设置指定索引处的 TraceListener。
Item[String]	获取列表中具有指定名称的第一个 TraceListener。

方法

Add(TraceListener)	将 TraceListener 添加到列表。
AddRange(TraceListener[])	将 TraceListener 对象的数组添加到列表。
AddRange(TraceListenerCollection)	将另一个 TraceListenerCollection 的内容添加到列表。
Clear()	从列表中清除所有侦听器。
Contains(TraceListener)	检查列表是否包含指定的侦听器。
CopyTo(TraceListener[], Int32)	将当前 TraceListenerCollection 列表的一部分复制到指定索引处的指定数组。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetEnumerator()	获取此列表的枚举数。
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
IndexOf(TraceListener)	获取指定侦听器的索引。
Insert(Int32, TraceListener)	将侦听器插入指定的索引位置。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
Remove(String)	从集合中移除具有指定名称的第一个 TraceListener。
Remove(TraceListener)	从集合中移除指定的 TraceListener。
RemoveAt(Int32)	从集合中移除指定索引处的 TraceListener。
ToString()	返回表示当前对象的字符串。 (继承自 Object)

显式接口实现

ICollection.CopyTo(Array, Int32)	将当前 TraceListenerCollection 的一部分复制到指定的 TraceListener 对象数组中。
ICollection.IsSynchronized	获取一个值，该值指示是否同步对 TraceListenerCollection 的访问（线程安全）。
ICollection.SyncRoot	获取可用于同步对 TraceListenerCollection 的访问的对象。
IList.Add(Object)	向 TraceListenerCollection 中添加一个跟踪侦听器。
IList.Contains(Object)	确定 TraceListenerCollection 是否包含特定对象。
IList.IndexOf(Object)	确定 TraceListenerCollection 中特定对象的索引。
IList.Insert(Int32, Object)	在 TraceListener 中的指定位置插入一个 TraceListenerCollection 对象。
IList.IsFixedSize	获取一个值，该值指示 TraceListenerCollection 是否具有固定大小。
IList.IsReadOnly	获取一个值，该值指示 TraceListenerCollection 是否为只读。
IList.Item[Int32]	获取或设置 TraceListener 的指定索引处的 TraceListenerCollection。
IList.Remove(Object)	从 TraceListenerCollection 中移除一个对象。

扩展方法

Cast<TResult>(IEnumerable)	将 IEnumerable 的元素强制转换为指定的类型。
OfType<TResult>(IEnumerable)	根据指定类型筛选 IEnumerable 的元素。
AsParallel(IEnumerable)	启用查询的并行化。
AsQueryable(IEnumerable)	将 IEnumerable 转换为 IQueryable。

另请参阅

• TraceListener
• DefaultTraceListener
• TextWriterTraceListener
• ConsoleTraceListener
• Debug
• Trace