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)

適用於

另請參閱