TraceContextEventArgs クラス

定義

TraceFinished イベントを処理するメソッドにトレース レコードのコレクションを提供します。 このクラスは継承できません。

public ref class TraceContextEventArgs sealed : EventArgs
public sealed class TraceContextEventArgs : EventArgs
type TraceContextEventArgs = class
    inherit EventArgs
Public NotInheritable Class TraceContextEventArgs
Inherits EventArgs
継承
TraceContextEventArgs

次のコード例は、イベントを処理するためにデリゲートを TraceContextEventHandler 登録する方法を TraceFinished 示しています。 この例では、 メソッドは OnTraceFinished 、 プロパティを介してオブジェクトの TraceContextRecord コレクションに TraceRecords アクセスし、それらを反復処理して、応答ストリームに書き込みます。

<%@ 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)

適用対象

こちらもご覧ください