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 窗体输出。 代码示例演示包含 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 架构) 部分<的侦听器 Web.config 文件中添加WebPageTraceListener对象来启用跟踪转发。 还可以以编程方式将 添加到 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) |
