WebPageTraceListener 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
提供用來導向 Trace 訊息至 ASP.NET 網頁輸出的接聽程式。
public ref class WebPageTraceListener : System::Diagnostics::TraceListenerpublic class WebPageTraceListener : System.Diagnostics.TraceListenertype WebPageTraceListener = class
inherit TraceListenerPublic Class WebPageTraceListener
Inherits TraceListener- 繼承
範例
下列程式代碼範例示範如何將訊息路由 Trace 傳送至 Web 窗體輸出。 程式代碼範例顯示包含和 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)。 如需詳細資訊，請參閱 HostProtectionAttribute 類別或 SQL Server 程式設計和主機保護屬性。
類別 WebPageTraceListener 會將寫入記錄的 Trace 追蹤訊息轉送至網頁輸出通道 ASP.NET。 您可以在 system.diagnostics> 區段的 trace Element (ASP.NET Settings Schema) 子區段中<，將 物件新增WebPageTraceListener至您的 Web.config 檔案作為接聽程式，以啟用追蹤轉送。 您也可以以程式設計方式將 新增 WebPageTraceListener 至接聽程式集合。 通常，這是在應用程式啟動期間，使用 Application_Start Global.asax 檔案中的 方法，將 新增WebPageTraceListener至集合來完成。
建構函式
| WebPageTraceListener() |
初始化 WebPageTraceListener 類別的新執行個體。 |
屬性
| Attributes |
取得在應用程式組態檔中定義的自訂追蹤接聽程式屬性。 (繼承來源 TraceListener) |
| Filter |
取得或設定追蹤接聽程式的追蹤篩選。 (繼承來源 TraceListener) |
| IndentLevel |
取得或設定縮排層級。 (繼承來源 TraceListener) |
| IndentSize |
取得或設定縮排的空格數目。 (繼承來源 TraceListener) |
| IsThreadSafe |
取得值，指出追蹤接聽程式是否為安全執行緒。 (繼承來源 TraceListener) |
| Name |
取得或設定這個 TraceListener 的名稱。 (繼承來源 TraceListener) |
| NeedIndent |
取得或設定值，指出是否要縮排輸出。 (繼承來源 TraceListener) |
| TraceOutputOptions |
取得或設定追蹤輸出選項。 (繼承來源 TraceListener) |
