TraceListener 類別

定義

命名空間:
System.Diagnostics
組件:
netstandard.dll, System.Diagnostics.TraceSource.dll
組件:
System.Diagnostics.TraceSource.dll
組件:
System.dll
組件:
netstandard.dll
來源:
TraceListener.cs
來源:
TraceListener.cs
來源:
TraceListener.cs
來源:
TraceListener.cs
來源:
TraceListener.cs

提供 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。>

給實施者的注意事項

從這個類別繼承來實作一個自訂DebugTrace的 和 類別監聽器。 至少，你必須實作 Write(String) and WriteLine(String) 方法。 此外，你也可以實作 Fail(String)、 和 Close()Flush() 方法。

建構函式

名稱 Description
TraceListener()

初始化 TraceListener 類別的新執行個體。
TraceListener(String)

初始化一個新的類別實例 TraceListener ，並以指定的名稱作為監聽器。

屬性

名稱 Description
Attributes

取得應用程式設定檔中定義的自訂追蹤監聽器屬性。
Filter

取得或設定追蹤監聽器的追蹤過濾器。
IndentLevel

取得或設定縮排等級。
IndentSize

取得或設定縮排中的空格數。
IsThreadSafe

會獲得一個值，表示追蹤監聽器是否執行緒安全。
Name

為此 TraceListener命名或命名。
NeedIndent

取得或設定一個值，指示是否要縮排輸出。
TraceOutputOptions

取得或設定追蹤輸出選項。

方法

名稱 Description
Close()

當在派生類別中覆寫時，會關閉輸出串流，使其不再接收追蹤或除錯輸出。
CreateObjRef(Type)

建立一個物件，包含產生代理伺服器所需的所有相關資訊，用於與遠端物件通訊。

(繼承來源 MarshalByRefObject)
Dispose()

釋放 TraceListener所使用的所有資源。
Dispose(Boolean)

釋放 未管理的資源， TraceListener 並可選擇性地釋放受管理資源。
Equals(Object)

判斷指定的物件是否等於目前的物件。

(繼承來源 Object)
Fail(String, String)

在你實作 TraceListener 類別時，會向你建立的監聽器發出錯誤訊息和詳細錯誤訊息。
Fail(String)

當你實作類別 TraceListener 時，會向你建立的監聽器發出錯誤訊息。
Flush()

當在衍生類別中覆寫時，會清除輸出緩衝區。
GetHashCode()

做為預設哈希函式。

(繼承來源 Object)
GetLifetimeService()
已淘汰.

擷取控制這個實例存留期原則的目前存留期服務物件。

(繼承來源 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, String, Object[])

將追蹤資訊、格式化的物件陣列及事件資訊寫入監聽器專屬輸出。
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

將追蹤資訊、訊息及事件資訊寫入監聽器特定的輸出。
TraceEvent(TraceEventCache, String, TraceEventType, Int32)

將追蹤與事件資訊寫入聽者專屬輸出。
TraceTransfer(TraceEventCache, String, Int32, String, Guid)

將追蹤資訊、訊息、相關活動身份及事件資訊寫入監聽器特定輸出。
Write(Object, String)

在你實作ToString()類別時，會把類別名稱和物件TraceListener方法的值寫給你建立的監聽器。
Write(Object)

它會把物件 ToString() 方法的值寫給你實作 TraceListener 類別時建立的監聽器。
Write(String, String)

當你實作 TraceListener 類別時，會寫一個類別名稱和訊息給你建立的監聽器。
Write(String)

當在衍生類別中覆寫時，會將指定的訊息寫入你在衍生類別中建立的監聽器。
WriteIndent()

當你實作這個類別時，會把縮排寫入你建立的監聽器，並將屬性重設 NeedIndent 為 false。
WriteLine(Object, String)

在你實作ToString()類別時，會把類別名稱和物件TraceListener方法的值寫給你建立的監聽器，接著是行終止符。
WriteLine(Object)

它會將物件 ToString() 方法的值寫入你實作 TraceListener 類別時建立的監聽器，接著是行終止符。
WriteLine(String, String)

在你實作 TraceListener 類別時，會寫一個類別名稱和訊息給你建立的監聽器，接著是行終止符。
WriteLine(String)

當在派生類別中覆寫時，會寫入訊息給你在衍生類別中建立的監聽器，接著是行終止符。

適用於

執行緒安全性

此類型是安全線程。

另請參閱