TraceContextEventArgs

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

TraceContextEventArgs クラス

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

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

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

Visual Basic (宣言)

Public NotInheritable Class
 TraceContextEventArgs
    Inherits EventArgs

Visual Basic (使用法)

Dim instance As TraceContextEventArgs

C#

public sealed class TraceContextEventArgs :
 EventArgs

C++

public ref class TraceContextEventArgs sealed
 : public EventArgs

J#

public final class TraceContextEventArgs extends
 EventArgs

JScript

public final class TraceContextEventArgs extends
 EventArgs

解説

TraceContextEventArgs クラスは TraceContext クラスによって使用され、HTTP の要求処理中にすべてのトレース情報が収集された後、トレース レコードにアクセスできるようにします。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>

.NET Framework のセキュリティ

• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可) 要求値 : LinkDemand; アクセス許可値 : Minimal。

継承階層

System.Object
   System.EventArgs
    System.Web.TraceContextEventArgs

スレッド セーフ

この型の 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

参照

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

TraceContextEventArgs コンストラクタ

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

トレース レコードのコレクションを指定して、TraceContextEventArgs クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    records As ICollection _
)

Visual Basic (使用法)

Dim records As ICollection

Dim instance As New TraceContextEventArgs(records)

C#

public TraceContextEventArgs (
    ICollection records
)

C++

public:
TraceContextEventArgs (
    ICollection^ records
)

J#

public TraceContextEventArgs (
    ICollection records
)

JScript

public function TraceContextEventArgs (
    records : ICollection
)

パラメータ

records

現在の要求について記録されたすべてのトレース レコードを表す TraceContextRecord オブジェクトのコレクション。

プラットフォーム

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

参照

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

TraceContextEventArgs プロパティ

パブリック プロパティ

	名前	説明
	TraceRecords	現在の要求に関連付けられている TraceContextRecord メッセージのコレクションを取得します。

参照

関連項目

TraceContextEventArgs クラス
System.Web 名前空間
TraceContextEventHandler
TraceContext.TraceFinished イベント
TraceContext クラス

その他の技術情報

ASP.NET のトレース

TraceContextEventArgs メソッド

パブリック メソッド

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

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

プロテクト メソッド

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

参照

関連項目

TraceContextEventArgs クラス
System.Web 名前空間
TraceContextEventHandler
TraceContext.TraceFinished イベント
TraceContext クラス

その他の技術情報

ASP.NET のトレース

TraceContextEventArgs メンバ

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

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

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

	名前	説明
	TraceContextEventArgs	トレース レコードのコレクションを指定して、TraceContextEventArgs クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	TraceRecords	現在の要求に関連付けられている 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 から継承されます。)

参照

関連項目

TraceContextEventArgs クラス
System.Web 名前空間
TraceContextEventHandler
TraceContext.TraceFinished イベント
TraceContext クラス

その他の技術情報

ASP.NET のトレース