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 、 プロパティを介してオブジェクトの 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>

注釈

オブジェクトは TraceContextRecord 、トレース メッセージ、カテゴリ、関連付けられている Exceptionすべての 、およびトレース レコードが メソッドによって TraceContext.Warn 書き込まれたかどうかをカプセル化します。

メソッドと TraceContext.Warn メソッドをTraceContext.Write呼び出すたびに、メッセージ コレクションに追加される オブジェクトがTraceContextEventArgs.TraceRecords生成TraceContextRecordされます。 イベントを処理することで、レコードのコレクションに 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 ページのトレースを有効にする