WebPageTraceListener 類別

參考

定義

命名空間:: System.Web

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

提供用來導向 Trace 訊息至 ASP.NET 網頁輸出的接聽程式。

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

範例

下列程式碼範例示範如何將訊息路由 Trace 傳送至 Web 表單輸出。程式碼範例示範包含 BulletedList 和 AccessDataSource 控制項的一般 Web 表單。追蹤會在 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)

方法

Close()	當在衍生類別中覆寫時，關閉輸出資料流，使它不再接收追蹤或偵錯輸出。 (繼承來源 TraceListener)
CreateObjRef(Type)	建立包含所有相關資訊的物件，這些資訊是產生用來與遠端物件通訊的所需 Proxy。 (繼承來源 MarshalByRefObject)
Dispose()	釋放 TraceListener 所使用的所有資源。 (繼承來源 TraceListener)
Dispose(Boolean)	釋放 TraceListener 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。 (繼承來源 TraceListener)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
Fail(String)	當您實作 TraceListener 類別時，發出錯誤訊息給您建立的接聽程式。 (繼承來源 TraceListener)
Fail(String, String)	當您實做 TraceListener 類別時，發出錯誤訊息和詳細的錯誤訊息給您建立的接聽程式。 (繼承來源 TraceListener)
Flush()	當在衍生類別中覆寫時，會排清輸出緩衝區。 (繼承來源 TraceListener)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetLifetimeService()	已淘汰. 擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。 (繼承來源 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)	使用指定的系統和事件資料，將事件訊息寫入網頁或 ASP.NET 追蹤檢視器。
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	使用指定的系統和事件資料，將當地語系化事件訊息寫入網頁或 ASP.NET 追蹤檢視器。
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	寫入追蹤資訊、訊息、相關活動身分識別與事件資訊至特定接聽程式的輸出。 (繼承來源 TraceListener)
Write(Object)	將物件的 ToString() 方法的值寫入當您實作 TraceListener 類別時所建立的接聽程式。 (繼承來源 TraceListener)
Write(Object, String)	將類別名稱和物件的 ToString() 方法的值寫入當您實作 TraceListener 類別時所建立的接聽程式。 (繼承來源 TraceListener)
Write(String)	將訊息寫入 Web 網頁或 ASP.NET 追蹤檢視器。
Write(String, String)	將分類名稱和訊息寫入網頁或 ASP.NET 追蹤檢視器。
WriteIndent()	將縮排寫入當您實作這個類別時所建立的接聽程式，並且將 NeedIndent 屬性重設為 `false`。 (繼承來源 TraceListener)
WriteLine(Object)	將物件的 ToString() 方法的值寫入當您實作 TraceListener 類別時所建立的接聽程式，後面跟隨著行結束字元。 (繼承來源 TraceListener)
WriteLine(Object, String)	將分類名稱和物件的 ToString() 方法的值寫入當您實作 TraceListener 類別時所建立的接聽程式，後面跟隨著行結束字元。 (繼承來源 TraceListener)
WriteLine(String)	將訊息寫入 Web 網頁或 ASP.NET 追蹤檢視器。
WriteLine(String, String)	將分類名稱和訊息寫入網頁或 ASP.NET 追蹤檢視器。

適用於

另請參閱

ASP.NET 追蹤概觀

WebPageTraceListener 類別

定義

範例

備註

建構函式

屬性

方法

適用於

另請參閱

意見反應

其他資源