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.Write 和 TraceContext.Warn 方法時，都會 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)

適用於

另請參閱