TraceListener 類別

  • 參考

定義

命名空間:
System.Diagnostics
組件:
System.Diagnostics.TraceSource.dll
組件:
System.dll
組件:
netstandard.dll

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

public ref class TraceListener abstract : MarshalByRefObject, IDisposable
public ref class TraceListener abstract : IDisposable
public abstract class TraceListener : MarshalByRefObject, IDisposable
public abstract class TraceListener : IDisposable
type TraceListener = class
    inherit MarshalByRefObject
    interface IDisposable
type TraceListener = class
    interface IDisposable
Public MustInherit Class TraceListener
Inherits MarshalByRefObject
Implements IDisposable
Public MustInherit Class TraceListener
Implements IDisposable
繼承
Object
MarshalByRefObject
TraceListener
繼承
Object
TraceListener
衍生
實作
IDisposable

備註

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

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

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

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

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

<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 類別時所建立的接聽程式，後面跟隨著行結束字元。

適用於

執行緒安全性

此型別具備執行緒安全。

另請參閱