TraceContextEventArgs 類別

定義

命名空間:

System.Web

組件:

System.Web.dll

將追蹤記錄的集合提供給處理 TraceFinished 事件的任何方法。 此類別無法獲得繼承。

public ref class TraceContextEventArgs sealed : EventArgs

public sealed class TraceContextEventArgs : EventArgs

type TraceContextEventArgs = class
    inherit EventArgs

Public NotInheritable Class TraceContextEventArgs
Inherits EventArgs

繼承

Object

EventArgs

TraceContextEventArgs

範例

下列程式代碼範例示範如何註冊 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>

備註

類別 TraceContextEventArgs 會由 TraceContext 類別用來在 HTTP 要求處理期間收集所有追蹤資訊之後，提供追蹤記錄的存取權。 藉由新增事件處理程式委派來處理 TraceFinished 事件，您可以處理記錄、將其記錄記錄到您自己的數據存放區，或將它們提供為分析工具的輸入。

建構函式

TraceContextEventArgs(ICollection)

使用提供的追蹤記錄集合，初始化 TraceContextEventArgs 類別的新執行個體。

屬性

TraceRecords

取得與目前要求相關聯的 TraceContextRecord 訊息集合。

方法

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

另請參閱

• TraceContextEventHandler
• TraceFinished
• TraceContext
• ASP.NET 追蹤概觀