WebPageTraceListener 类

定义

提供一个将 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
继承
WebPageTraceListener

示例

下面的代码示例演示如何将消息路由 Trace 到 Web 窗体输出。 该代码示例演示包含 BulletedListAccessDataSource 控件的典型 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属性值:SynchronizationHostProtectionAttribute 不影响桌面应用程序(通常通过双击图标、键入命令或在浏览器中输入 URL 来启动这些应用程序)。 有关详细信息,请参阅 HostProtectionAttribute 类或SQL Server编程和主机保护属性

WebPageTraceListener 将写入日志的 Trace 跟踪消息转发到 ASP.NET 网页输出通道。 可以通过将 对象作为侦听器添加到 WebPageTraceListenersystem.diagnostics> 部分的 trace Element (ASP.NET Settings Schema) 子部分中<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)

创建一个对象,该对象包含生成用于与远程对象进行通信的代理所需的全部相关信息。

(继承自 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)

使用指定的系统数据和事件数据将事件消息写入网页或写入 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)

向网页或 ASP.NET 跟踪查看器中写入消息。

Write(String, String)

向网页或 ASP.NET 跟踪查看器中写入类别名称和消息。

WriteIndent()

实现此类时,向所创建的侦听器写入缩进,并将 NeedIndent 属性重置为 false

(继承自 TraceListener)
WriteLine(Object)

实现 TraceListener 类时,向所创建的侦听器写入对象的 ToString() 方法值,后跟行结束符。

(继承自 TraceListener)
WriteLine(Object, String)

实现 TraceListener 类时,向所创建的侦听器写入类别名称和对象的 ToString() 方法值,后跟行结束符。

(继承自 TraceListener)
WriteLine(String)

向网页或 ASP.NET 跟踪查看器中写入消息。

WriteLine(String, String)

向网页或 ASP.NET 跟踪查看器中写入类别名称和消息。

适用于

另请参阅