WebPageTraceListener クラス

リファレンス

定義

名前空間:: System.Web

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

public ref class WebPageTraceListener : System::Diagnostics::TraceListener

public class WebPageTraceListener : System.Diagnostics.TraceListener

type WebPageTraceListener = class
    inherit TraceListener

Public Class WebPageTraceListener
Inherits TraceListener

継承: Object

MarshalByRefObject

TraceListener
WebPageTraceListener

例

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

<%@ 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 xmlns="http://www.w3.org/1999/xhtml">
<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>

<%@ 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 xmlns="http://www.w3.org/1999/xhtml">
<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>

注釈

注意

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

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

コンストラクター

WebPageTraceListener()

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

プロパティ

Attributes	アプリケーション構成ファイルに定義されているトレースリスナーのカスタム属性を取得します。 (継承元 TraceListener)
Filter	トレースリスナーのトレースフィルターを取得または設定します。 (継承元 TraceListener)
IndentLevel	インデントレベルを取得または設定します。 (継承元 TraceListener)
IndentSize	1 つのインデントに含まれるスペースの数を取得または設定します。 (継承元 TraceListener)
IsThreadSafe	トレースリスナーがスレッドセーフかどうかを示す値を取得します。 (継承元 TraceListener)
Name	この TraceListener の名前を取得または設定します。 (継承元 TraceListener)
NeedIndent	出力にインデントを設定するかどうかを示す値を取得または設定します。 (継承元 TraceListener)
TraceOutputOptions	トレース出力オプションを取得または設定します。 (継承元 TraceListener)

メソッド

Close()	派生クラスでオーバーライドされた場合、出力ストリームを終了して、トレース出力またはデバッグ出力を受信しないようにします。 (継承元 TraceListener)
CreateObjRef(Type)	リモートオブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (継承元 MarshalByRefObject)
Dispose()	TraceListener によって使用されているすべてのリソースを解放します。 (継承元 TraceListener)
Dispose(Boolean)	TraceListener によって使用されているアンマネージドリソースを解放し、オプションでマネージドリソースも解放します。 (継承元 TraceListener)
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
Fail(String)	TraceListener クラスを実装した場合、作成したリスナーにエラーメッセージを出力します。 (継承元 TraceListener)
Fail(String, String)	TraceListener クラスを実装した場合、作成したリスナーにエラーメッセージと詳細エラーメッセージを出力します。 (継承元 TraceListener)
Flush()	派生クラスでオーバーライドされた場合、出力バッファーをフラッシュします。 (継承元 TraceListener)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetLifetimeService()	古い. 対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービスオブジェクトを取得します。 (継承元 MarshalByRefObject)
GetSupportedAttributes()	トレースリスナーによってサポートされるカスタム属性を取得します。 (継承元 TraceListener)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
InitializeLifetimeService()	古い. このインスタンスの有効期間ポリシーを制御する有効期間サービスオブジェクトを取得します。 (継承元 MarshalByRefObject)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
MemberwiseClone(Boolean)	現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。 (継承元 MarshalByRefObject)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	トレース情報、データオブジェクト、およびイベント情報をリスナー固有の出力に書き込みます。 (継承元 TraceListener)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	トレース情報、データオブジェクトの配列、およびイベント情報をリスナー固有の出力に書き込みます。 (継承元 TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	トレース情報およびイベント情報をリスナー固有の出力に書き込みます。 (継承元 TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	指定したシステムデータとイベントデータを使用して、イベントメッセージを Web ページまたは ASP.NET トレースビューアーに書き込みます。
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	指定したシステムデータとイベントデータを使用して、ローカライズされたイベントメッセージを Web ページまたは ASP.NET トレースビューアーに書き込みます。
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	トレース情報、メッセージ、関連するアクティビティ ID、およびイベント情報をリスナー固有の出力に書き込みます。 (継承元 TraceListener)
Write(Object)	オブジェクトの ToString() メソッドの値を、TraceListener クラスを実装した時に作成したリスナーに書き込みます。 (継承元 TraceListener)
Write(Object, String)	カテゴリ名と、オブジェクトの ToString() メソッドの値を、TraceListener クラスを実装するときに作成したリスナーに書き込みます。 (継承元 TraceListener)
Write(String)	メッセージを Web ページまたは ASP.NET トレースビューアーに書き込みます。
Write(String, String)	カテゴリ名とメッセージを Web ページまたは ASP.NET トレースビューアーに書き込みます。
WriteIndent()	このクラスの実装時に作成したリスナーにインデントを書き込み、NeedIndent プロパティを `false` にリセットします。 (継承元 TraceListener)
WriteLine(Object)	TraceListener クラスの実装時に作成したリスナーにオブジェクトの ToString() メソッドの値と行終端記号を書き込みます。 (継承元 TraceListener)
WriteLine(Object, String)	TraceListener クラスの実装時に作成したリスナーにカテゴリ名、オブジェクトの ToString() メソッドの値、および行終端記号を書き込みます。 (継承元 TraceListener)
WriteLine(String)	メッセージを Web ページまたは ASP.NET トレースビューアーに書き込みます。
WriteLine(String, String)	カテゴリ名とメッセージを Web ページまたは ASP.NET トレースビューアーに書き込みます。

適用対象

こちらもご覧ください

ASP.NET のトレースの概要