TraceListenerCollection 類別

定義

命名空間:

System.Diagnostics

組件:

System.Diagnostics.TraceSource.dll

來源:

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清單用來指定 和集合的輸出接聽程式Trace.ListenersDebug.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