TraceListener 類別

定義

命名空間:

System.Diagnostics

組件:

System.Diagnostics.TraceSource.dll

來源:

TraceListener.cs

為監視追蹤和偵錯輸出的接聽程式提供 abstract 基底類別。

C#

public abstract class TraceListener : MarshalByRefObject, IDisposable

繼承

Object

MarshalByRefObject

TraceListener

衍生

Microsoft.VisualBasic.Logging.FileLogTraceListener

System.Diagnostics.DefaultTraceListener

System.Diagnostics.Eventing.EventProviderTraceListener

System.Diagnostics.EventLogTraceListener

System.Diagnostics.TextWriterTraceListener

System.Web.IisTraceListener

System.Web.WebPageTraceListener

實作

IDisposable

備註

如需如何實 TraceListener作 的範例，請參閱 DefaultTraceListener和 TextWriterTraceListenerEventLogTraceListener 類別。

您必須啟用追蹤或偵錯，才能使用追蹤接聽程式。 下列語法是編譯程式特有的。 如果您使用 C# 或 Visual Basic 以外的編譯程式，請參閱編譯程式的檔。

• 若要在 C# 中啟用偵錯，請在編譯程式程式代碼時，將旗標新增 /d:DEBUG 至編譯程式命令行，或者您可以新增 #define DEBUG 至檔案頂端。 在 Visual Basic 中，將 /d:DEBUG=True 旗標新增至編譯程式命令行。

• 若要在 C# 中啟用追蹤，請在編譯程式程式程式代碼時，將旗標新增 /d:TRACE 至編譯程式命令行，或新增 #define TRACE 至檔案頂端。 在 Visual Basic 中，將 /d:TRACE=True 旗標新增至編譯程式命令行。

若要新增追蹤接聽程式，請編輯對應至應用程式名稱的組態檔。 在此檔案中，您可以新增接聽程式、設定其類型並設定其參數、移除接聽程式，或清除應用程式先前設定的所有接聽程式。 組態檔的格式應該類似下列範例。

XML

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <add name="myListener" type="System.Diagnostics.TextWriterTraceListener" initializeData="TextWriterOutput.log" />  
        <remove name="Default" />  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>  

如需使用組態檔進行追蹤的詳細資訊，請參閱 <system.diagnostics>。

給實施者的注意事項

繼承自這個類別，以實作 和 Trace 類別的Debug自定義接聽程式。 您至少必須實 Write(String) 作 和 WriteLine(String) 方法。 此外，您可以實作 Fail(String)、 Close() 和 Flush() 方法。

建構函式

TraceListener()	初始化 TraceListener 類別的新執行個體。
TraceListener(String)	使用指定的名稱做為接聽程式來初始化 TraceListener 類別的新執行個體。

屬性

Attributes	取得在應用程式組態檔中定義的自訂追蹤接聽程式屬性。
Filter	取得或設定追蹤接聽程式的追蹤篩選。
IndentLevel	取得或設定縮排層級。
IndentSize	取得或設定縮排的空格數目。
IsThreadSafe	取得值，指出追蹤接聽程式是否為安全執行緒。
Name	取得或設定這個 TraceListener 的名稱。
NeedIndent	取得或設定值，指出是否要縮排輸出。
TraceOutputOptions	取得或設定追蹤輸出選項。

方法

Close()	當在衍生類別中覆寫時，關閉輸出資料流，使它不再接收追蹤或偵錯輸出。
CreateObjRef(Type)	建立包含所有相關資訊的物件，這些資訊是產生用來與遠端物件通訊的所需 Proxy。 (繼承來源 MarshalByRefObject)
Dispose()	釋放 TraceListener 所使用的所有資源。
Dispose(Boolean)	釋放 TraceListener 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
Fail(String)	當您實作 TraceListener 類別時，發出錯誤訊息給您建立的接聽程式。
Fail(String, String)	當您實做 TraceListener 類別時，發出錯誤訊息和詳細的錯誤訊息給您建立的接聽程式。
Flush()	當在衍生類別中覆寫時，會排清輸出緩衝區。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetLifetimeService()	已淘汰. 擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。 (繼承來源 MarshalByRefObject)
GetSupportedAttributes()	取得由追蹤接聽程式支援的自訂屬性。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
InitializeLifetimeService()	已淘汰. 取得存留期服務物件，以控制這個執行個體的存留期原則。 (繼承來源 MarshalByRefObject)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
MemberwiseClone(Boolean)	建立目前 MarshalByRefObject 物件的淺層複本。 (繼承來源 MarshalByRefObject)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	寫入追蹤資訊、資料物件與事件資訊至特定接聽程式的輸出。
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	寫入追蹤資訊、資料物件的陣列與事件資訊至特定接聽程式的輸出。
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	寫入追蹤和事件資訊至特定接聽程式的輸出。
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	寫入追蹤資訊、訊息與事件資訊至特定接聽程式的輸出。
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	寫入追蹤資訊、格式化的物件陣列與事件資訊至特定接聽程式的輸出。
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	寫入追蹤資訊、訊息、相關活動身分識別與事件資訊至特定接聽程式的輸出。
Write(Object)	將物件的 ToString() 方法的值寫入當您實作 TraceListener 類別時所建立的接聽程式。
Write(Object, String)	將類別名稱和物件的 ToString() 方法的值寫入當您實作 TraceListener 類別時所建立的接聽程式。
Write(String)	當在衍生類別中覆寫時，將指定的訊息寫入您在衍生類別中建立的接聽程式。
Write(String, String)	將分類名稱和訊息寫入當您實作 TraceListener 類別時所建立的接聽程式。
WriteIndent()	將縮排寫入當您實作這個類別時所建立的接聽程式，並且將 NeedIndent 屬性重設為 false。
WriteLine(Object)	將物件的 ToString() 方法的值寫入當您實作 TraceListener 類別時所建立的接聽程式，後面跟隨著行結束字元。
WriteLine(Object, String)	將分類名稱和物件的 ToString() 方法的值寫入當您實作 TraceListener 類別時所建立的接聽程式，後面跟隨著行結束字元。
WriteLine(String)	當在衍生類別中覆寫時，將訊息寫入您在衍生類別中所建立的接聽程式，後面跟隨著行結束字元。
WriteLine(String, String)	將分類名稱和訊息寫入當您實作 TraceListener 類別時所建立的接聽程式，後面跟隨著行結束字元。

適用於

執行緒安全性

此型別具備執行緒安全。

另請參閱

• DefaultTraceListener
• ConsoleTraceListener
• EventLogTraceListener
• TextWriterTraceListener
• Debug
• Trace
• <system.diagnostics> 元素