WebPageTraceListener クラス

定義

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
継承
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 トレース ビューアーに書き込みます。

適用対象

こちらもご覧ください