TraceContextRecord

.NET Framework クラス ライブラリ リファレンス

TraceContextRecord クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

ASP.NET のトレース メッセージと関連データを表します。

名前空間: System.Web
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 TraceContextRecord

Visual Basic (使用法)

Dim instance As TraceContextRecord

C#

public sealed class TraceContextRecord

C++

public ref class TraceContextRecord sealed

J#

public final class TraceContextRecord

JScript

public final class TraceContextRecord

解説

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

System.Web.TraceContext.Write メソッドおよび System.Web.TraceContext.Warn メソッドが呼び出されるたびに、TraceContextEventArgs.TraceRecords メッセージ コレクションに追加される TraceContextRecord オブジェクトが生成されます。レコードのコレクションには、TraceFinished イベントの処理によってアクセスできます。

使用例

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

Visual Basic

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

C#

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

継承階層

System.Object
  System.Web.TraceContextRecord

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TraceContextRecord メンバ
System.Web 名前空間
TraceContextEventArgs クラス
TraceContextEventHandler デリゲート
その他の技術情報
ASP.NET のトレース
方法 : ASP.NET ページのトレースを有効にする

TraceContextRecord コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

TraceContextRecord クラスの新しいインスタンスを初期化します。

名前空間: System.Web
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    category As String, _
    msg As String, _
    isWarning As Boolean, _
    errorInfo As Exception _
)

Visual Basic (使用法)

Dim category As String
Dim msg As String
Dim isWarning As Boolean
Dim errorInfo As Exception

Dim instance As New TraceContextRecord(category,
 msg, isWarning, errorInfo)

C#

public TraceContextRecord (
    string category,
    string msg,
    bool isWarning,
    Exception errorInfo
)

C++

public:
TraceContextRecord (
    String^ category, 
    String^ msg, 
    bool isWarning, 
    Exception^ errorInfo
)

J#

public TraceContextRecord (
    String category, 
    String msg, 
    boolean isWarning, 
    Exception errorInfo
)

JScript

public function TraceContextRecord (
    category : String, 
    msg : String, 
    isWarning : boolean, 
    errorInfo : Exception
)

パラメータ

category

メッセージを受信するトレース カテゴリ。

msg

トレース メッセージ。

isWarning

TraceContextRecord に関連付けられているメソッドが Warn メソッドの場合は true。トレース メソッドが Write メソッドの場合は false。

errorInfo

追加のエラー情報を格納している Exception オブジェクト。

解説

System.Web.TraceContext.Write メソッドおよび System.Web.TraceContext.Warn メソッドが呼び出されるたびに、TraceContextEventArgs.TraceRecords メッセージ コレクションに追加される TraceContextRecord オブジェクトが生成されます。IsWarning プロパティは、Warn メソッドが呼び出されると true に設定され、Write メソッドが呼び出されると false に設定されます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TraceContextRecord クラス
TraceContextRecord メンバ
System.Web 名前空間
その他の技術情報
ASP.NET のトレース

TraceContextRecord プロパティ

パブリック プロパティ

	名前	説明
	Category	トレース レコード用のユーザー定義のカテゴリを取得します。
	ErrorInfo	トレース レコードに関連付けられている Exception がある場合は、それを取得します。
	IsWarning	トレース レコードが System.Web.TraceContext.Warn メソッドの呼び出しに関連付けられているかどうかを示す値を取得します。
	Message	ユーザー定義のトレース メッセージを取得します。

参照

関連項目

TraceContextRecord クラス
System.Web 名前空間
TraceContextEventArgs クラス
TraceContextEventHandler デリゲート

その他の技術情報

ASP.NET のトレース
方法 : ASP.NET ページのトレースを有効にする

TraceContextRecord メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

TraceContextRecord クラス
System.Web 名前空間
TraceContextEventArgs クラス
TraceContextEventHandler デリゲート

その他の技術情報

ASP.NET のトレース
方法 : ASP.NET ページのトレースを有効にする

TraceContextRecord メンバ

ASP.NET のトレース メッセージと関連データを表します。

TraceContextRecord データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	TraceContextRecord	TraceContextRecord クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	Category	トレース レコード用のユーザー定義のカテゴリを取得します。
	ErrorInfo	トレース レコードに関連付けられている Exception がある場合は、それを取得します。
	IsWarning	トレース レコードが System.Web.TraceContext.Warn メソッドの呼び出しに関連付けられているかどうかを示す値を取得します。
	Message	ユーザー定義のトレース メッセージを取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

TraceContextRecord クラス
System.Web 名前空間
TraceContextEventArgs クラス
TraceContextEventHandler デリゲート

その他の技術情報

ASP.NET のトレース
方法 : ASP.NET ページのトレースを有効にする