TraceContext 類別

定義

命名空間:

System.Web

組件:

System.Web.dll

擷取並提出關於 Web 要求的執行詳細資料。 此類別無法獲得繼承。

public ref class TraceContext sealed

public sealed class TraceContext

type TraceContext = class

Public NotInheritable Class TraceContext

繼承

Object

TraceContext

備註

您可以使用這個類別，將訊息附加至特定的追蹤類別。 例如，如果您要為應用程式建立 類別的 Calendar 實例，您可能會在轉譯程式中包含追蹤訊息「開始轉譯」，以及事件處理常式程式中的「引發 OnChange 事件」。

您也可以使用 TraceContext 類別，在要求執行結束時取得一組追蹤記錄，以進行自訂處理。 如需詳細資訊，請參閱ASP.NET 追蹤概觀。

若要啟用追蹤，請將 Trace @ Page 指示詞中的 屬性或 IsEnabled 屬性設定為 true 。 啟用追蹤時，除了顯示使用者提供的追蹤內容之外，類別 Page 也會自動包含每個要求的效能資料、控制樹狀結構資訊和狀態管理內容。

建構函式

TraceContext(HttpContext)

初始化 TraceContext 類別的新執行個體。

屬性

IsEnabled	取得或設定值，表示是否已針對目前的 Web 要求啟用追蹤。
TraceMode	取得或設定已排序的順序，追蹤訊息依此順序輸出至提出要求的瀏覽器。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
Warn(String)	將追蹤資訊寫入檢測檔。 所有警告在記錄檔中顯示為紅色文字。
Warn(String, String)	將追蹤資訊寫入檢測檔，包括任何使用者定義的分類和追蹤訊息。 所有警告在記錄檔中顯示為紅色文字。
Warn(String, String, Exception)	將追蹤資訊寫入追蹤記錄檔，包括任何使用者定義的分類、追蹤訊息和錯誤資訊。 所有警告在記錄檔中顯示為紅色文字。
Write(String)	將追蹤資訊寫入檢測檔。
Write(String, String)	將追蹤資訊寫入檢測檔，包括訊息和任何使用者定義的分類。
Write(String, String, Exception)	將追蹤資訊寫入追蹤記錄檔，包括任何使用者定義的分類、追蹤訊息和錯誤資訊。

事件

TraceFinished

由 TraceContext 物件所引發，在收集所有要求資訊之後公開追蹤訊息。

另請參閱

• TraceContextEventArgs
• TraceContextEventHandler
• TraceContextRecord
• ASP.NET 追蹤概觀