TraceContextRecord 類別

定義

命名空間:

System.Web

組件:

System.Web.dll

表示 ASP.NET 追蹤訊息和任何關聯的資料。

public ref class TraceContextRecord sealed

public sealed class TraceContextRecord

type TraceContextRecord = class

Public NotInheritable Class TraceContextRecord

繼承

Object

TraceContextRecord

範例

下列程式代碼範例示範如何註冊 TraceContextEventHandler 委派來處理 TraceFinished 事件。 在此範例中，方法會OnTraceFinished透過 TraceRecords 屬性存取 物件的集合TraceContextRecord、逐一查看物件，並將其寫入響應數據流。

<%@ Page language="c#" Trace="true" %>
<script runat="server">
void Page_Load(object sender, EventArgs e)
{
    // Register a handler for the TraceFinished event.
    Trace.TraceFinished += new 
        TraceContextEventHandler(this.OnTraceFinished);

    // Write a trace message.
    Trace.Write("Web Forms Infrastructure Methods", "USERMESSAGE: Page_Load complete.");
}
 
// A TraceContextEventHandler for the TraceFinished event.
void OnTraceFinished(object sender, TraceContextEventArgs e)
{
    TraceContextRecord r = null;    
    
    // Iterate through the collection of trace records and write 
    // them to the response stream.
    foreach(object o in e.TraceRecords)
    {
        r = (TraceContextRecord)o;
        Response.Write(String.Format("trace message: {0} <BR>", r.Message));
    }
}       
</script>

<%@ Page language="VB" Trace="true" %>
<script runat="server">
' The Page_Load method.
Private Sub Page_Load(sender As Object, e As EventArgs)

    ' Register a handler for the TraceFinished event.
    AddHandler Trace.TraceFinished, AddressOf OnTraceFinished

    ' Write a trace message.
    Trace.Write("Web Forms Infrastructure Methods", "USERMESSAGE: Page_Load complete.")
End Sub ' Page_Load
 
' A TraceContextEventHandler for the TraceFinished event.
Private Sub OnTraceFinished(sender As Object, e As TraceContextEventArgs)

    Dim r As TraceContextRecord
    Dim o As Object
    
    ' Iterate through the collection of trace records and write 
    ' them to the response stream.

    For Each o In e.TraceRecords
        r = CType(o, TraceContextRecord)
        Response.Write(String.Format("trace message: {0} <BR>", r.Message))
    Next

End Sub ' OnTraceFinished
</script>

備註

物件 TraceContextRecord 會封裝追蹤訊息、類別、任何相關聯的 Exception，以及追蹤記錄是否由 TraceContext.Warn 方法寫入。

對 和 TraceContext.Warn 方法的每個呼叫TraceContext.Write都會TraceContextRecord產生物件，該物件會新增至TraceContextEventArgs.TraceRecords訊息集合。 您可以藉由處理 TraceFinished 事件來存取記錄的集合。

建構函式

TraceContextRecord(String, String, Boolean, Exception)

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

屬性

Category	取得追蹤記錄的使用者定義分類。
ErrorInfo	取得與追蹤記錄相關聯的 Exception (如果存在)。
IsWarning	取得值，表示追蹤記錄是否與 Warn 方法呼叫有關聯。
Message	取得使用者定義的追蹤訊息。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• TraceContextEventArgs
• TraceContextEventHandler
• ASP.NET 追蹤概觀
• 如何：啟用 ASP.NET 網頁的追蹤