Trace メッセージを ASP.NET Web ページ出力に転送するリスナを提供します。
名前空間: System.Web
アセンブリ: System.Web (system.web.dll 内)
Public Class WebPageTraceListener
Inherits TraceListener
Dim instance As WebPageTraceListener
public class WebPageTraceListener : TraceListener
public ref class WebPageTraceListener : public TraceListener
public class WebPageTraceListener extends TraceListener
public class WebPageTraceListener extends TraceListener
WebPageTraceListener クラスは、Trace ログに書き込まれたトレース メッセージを ASP.NET Web ページ出力チャネルに転送します。トレースの転送を有効にするには、WebPageTraceListener オブジェクトを Web.config ファイルの <system.diagnostics> 要素 セクションの trace 要素 (ASP.NET 設定スキーマ) サブセクションにリスナとして追加します。また、WebPageTraceListener をリスナのコレクションにプログラムによって追加することもできます。通常これは、Global.asax ファイルの Application_Start メソッドを使用して、アプリケーションの起動中に WebPageTraceListener をコレクションに追加することによって行います。
Trace メッセージを Web フォーム出力にルーティングする方法を次のコード例に示します。このコード例では、BulletedList コントロールと AccessDataSource コントロールを含む典型的な Web フォームが使用されています。トレースが Web フォームで有効になっており、トレース出力は表示時に Web フォームに追加されます。トレース メッセージは、トレース出力の Trace Information テーブルで確認できます。WebPageTraceListener が構成ファイルで適切に有効にされている場合、両方のトレース メッセージがカテゴリ "Trace Test" に表示されます。一方、WebPageTraceListener が有効になっていない場合は、TraceContext オブジェクトに書き込まれたトレース メッセージだけが表示されます。
<%@ 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 >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">
<asp:GridView
id="GridView1"
runat="server"
datasourceid="AccessDataSource1"/>
<asp:AccessDataSource
id="AccessDataSource1"
runat="server"
datafile="Northwind.mdb"
selectcommand="SELECT * FROM employees"/>
</form>
</body>
</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 >
<head>
<title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">
<asp:GridView
id="GridView1"
runat="server"
datasourceid="AccessDataSource1"/>
<asp:AccessDataSource
id="AccessDataSource1"
runat="server"
datafile="Northwind.mdb"
selectcommand="SELECT * FROM employees"/>
</form>
</body>
</html>
System.Object
System.MarshalByRefObject
System.Diagnostics.TraceListener
System.Web.WebPageTraceListener
この型の public static (Visual Basicでは共有) メンバはすべて,スレッド セーフです。インスタンス メンバの場合は,スレッド セーフであるとは限りません。
Windows 98,Windows Server 2000 SP4,Windows CE,Windows Millennium Edition,Windows Mobile for Pocket PC,Windows Mobile for Smartphone,Windows Server 2003,Windows XP Media Center Edition,Windows XP Professional x64 Edition,Windows XP SP2,Windows XP Starter Edition
Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。
.NET Framework
サポート対象 : 3.0,2.0