WebPageTraceListener クラスとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

WebPageTraceListener クラス

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

Trace メッセージを ASP.NET Web ページ出力に転送するリスナを提供します。

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

Visual Basic (宣言)

Public Class WebPageTraceListener
    Inherits TraceListener

Visual Basic (使用法)

Dim instance As WebPageTraceListener

public class WebPageTraceListener : TraceListener

C++

public ref class WebPageTraceListener : public
 TraceListener

public class WebPageTraceListener extends TraceListener

JScript

public class WebPageTraceListener extends
 TraceListener

解説

メモ
このクラスに適用される HostProtectionAttribute 属性は、Resources プロパティ値として Synchronization が設定されています。HostProtectionAttribute は、デスクトップアプリケーション (通常、アイコンのダブルクリック、コマンドの入力、またはブラウザへの URL の入力により起動されます) には影響しません。詳細については、HostProtectionAttribute クラスのトピックまたは「SQL Server プログラミングとホスト保護属性」を参照してください。

メモ

このクラスに適用される HostProtectionAttribute 属性は、Resources プロパティ値として Synchronization が設定されています。HostProtectionAttribute は、デスクトップアプリケーション (通常、アイコンのダブルクリック、コマンドの入力、またはブラウザへの URL の入力により起動されます) には影響しません。詳細については、HostProtectionAttribute クラスのトピックまたは「SQL Server プログラミングとホスト保護属性」を参照してください。

WebPageTraceListener クラスは、Trace ログに書き込まれたトレースメッセージを ASP.NET Web ページ出力チャネルに転送します。トレースの転送を有効にするには、WebPageTraceListener オブジェクトを Web.config ファイルの <system.diagnostics> 要素セクションの trace 要素 (ASP.NET 設定スキーマ) サブセクションにリスナとして追加します。また、WebPageTraceListener をリスナのコレクションにプログラムによって追加することもできます。通常これは、Global.asax ファイルの Application_Start メソッドを使用して、アプリケーションの起動中に WebPageTraceListener をコレクションに追加することによって行います。

Topic	Location
チュートリアル : ASP.NET トレースと System.Diagnostics トレースの統合	ASP .NET Web アプリケーションの作成

使用例

Trace メッセージを Web フォーム出力にルーティングする方法を次のコード例に示します。このコード例では、BulletedList コントロールと AccessDataSource コントロールを含む典型的な Web フォームが使用されています。トレースが Web フォームで有効になっており、トレース出力は表示時に Web フォームに追加されます。トレースメッセージは、トレース出力の Trace Information テーブルで確認できます。WebPageTraceListener が構成ファイルで適切に有効にされている場合、両方のトレースメッセージがカテゴリ "Trace Test" に表示されます。一方、WebPageTraceListener が有効になっていない場合は、TraceContext オブジェクトに書き込まれたトレースメッセージだけが表示されます。

Visual Basic

<%@ Page language="VB" trace=true %>

<script runat="server">
Private Sub Page_Load(sender As
 Object, e As EventArgs)
    
    Trace.Write("Trace Test","This
 message is written with the System.Web.TraceContext object.")

    System.Diagnostics.Trace.Write("Trace Test", "This
 message is forwarded to the TraceContext from System.Diagnostics using the WebPageTraceListener.")

End Sub ' Page_Load
</script>

<html>
<form runat="server">

<asp:GridView 
  id="GridView1"
  runat="server"
  datasourceid="AccessDataSource1"/>

<asp:AccessDataSource 
  id="AccessDataSource1"
  runat="server"
  datafile="Northwind.mdb"
  selectcommand="SELECT * FROM employees"/>

</form>
</html>

<%@ Page language="C#" trace=true %>

<script runat="server">
private void page_load(object sender, EventArgs
 e) {
    
    Trace.Write("Trace Test","This message is written with the TraceContext
 object.");

    System.Diagnostics.Trace.WriteLine("This message is forwarded to the TraceContext
 from System.Diagnostics using the WebPageTraceListener.");
}
</script>
<html>
<form runat="server">

<asp:GridView 
  id="GridView1"
  runat="server"
  datasourceid="AccessDataSource1"/>

<asp:AccessDataSource 
  id="AccessDataSource1"
  runat="server"
  datafile="Northwind.mdb"
  selectcommand="SELECT * FROM employees"/>

</form>
</html>