配置 ASP.NET 代码跟踪服务以控制如何收集、存储和显示跟踪结果。
configuration 元素（常规设置架构）??system.web 元素（ASP.NET 设置架构）
????trace 元素（ASP.NET 设置架构）
<trace enabled="true|false" localOnly="true|false" pageOutput="true|false" requestLimit="integer" mostRecent="true|false" writeToDiagnosticsTrace="true|false" traceMode="SortByTime|SortByCategory" /> |
属性和元素
下面几部分描述了属性、子元素和父元素。
属性
| 属性 | 说明 | ||||||
|---|---|---|---|---|---|---|---|
|
enabled |
可选的 指定是否为应用程序启用跟踪。为了使用 Trace.axd 查看器，必须启用跟踪。默认情况下，Trace.axd 查看器被添加到 httpHandlers 元素。 默认值为 false。 |
||||||
|
localOnly |
可选的 Boolean 属性。 指定跟踪查看器 (Trace.axd) 是否只用于主机 Web 服务器。如果是 false，则跟踪查看器可用于任何计算机。默认情况下，Trace.axd 查看器被添加到 httpHandlers 元素。 默认值为 true。 |
||||||
|
mostRecent |
可选的 Boolean 属性。 指定是否显示最近的应用程序级别跟踪输出，以及是否丢弃超出 requestLimit 指示的限制的旧跟踪数据。如果为 false，则显示对请求的跟踪数据，直至达到 requestLimit 属性指定的限制。 此属性是 .NET Framework 2.0 版中的新属性。 默认值为 false。 |
||||||
|
pageOutput |
可选的 Boolean 属性。 指定在每一页的结尾是否呈现跟踪输出。如果是 false，则只能通过跟踪实用工具访问跟踪输出。 默认值为 false。 |
||||||
|
requestLimit |
可选的 指定在服务器上存储的跟踪请求的数目。如果达到限制，并且 mostRecent 属性为 false，将自动禁用跟踪。 最大请求限制为 10,000。如果指定了大于 10,000 的值，ASP.NET 会在不给出任何提示的情况下将它向下舍入到 10,000。 默认值为 10。 |
||||||
|
traceMode |
可选的 指定显示跟踪信息的顺序。 traceMode 属性可以为下列可能值之一。
默认值为 SortByTime。 |
||||||
|
writeToDiagnosticsTrace |
可选的 Boolean 属性。 指定是否将 ASP.NET 跟踪消息转发到 此属性是 .NET Framework 2.0 版中的新属性。 默认值为 false。 |
子元素
无。
父元素
| 元素 | 说明 |
|---|---|
|
configuration |
公共语言运行库和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。 |
|
system.web |
指定配置文件中 ASP.NET 配置设置的根元素，并且包含各种用于配置 ASP.NET Web 应用程序和控制应用程序的行为方式的配置元素。 |
备注
trace 元素配置 ASP.NET 代码跟踪服务以控制如何收集、存储和显示跟踪结果。
当启用跟踪时，每个页请求生成可以追加到页输出或存储在应用程序跟踪日志中的跟踪消息。可以使用 ASP.NET 跟踪查看器 (Trace.axd) 来查看跟踪日志的内容。默认情况下，Trace.axd 被添加到 httpHandlers 元素。
 注意 |
|---|
|
一般来说，不应在活动网站上启用跟踪，因为这会向查看该网站页面的任何人显示敏感的配置信息。跟踪仅用于调试目的。如果 localOnly 属性为 true，则只为本地主机请求显示跟踪信息。另外，如果在 Web.config 文件中设置 <deployment retail=true>，将会禁用跟踪。 |
可以使用 Trace 类中的属性和方法来检测发布版本。检测使您能通过在实际设置下运行应用程序来监视应用程序的运行状况。跟踪技术可帮助您隔离和修复问题，而不中断正在运行的系统。
默认配置
下面的默认 trace 元素不是在 Machine.config 文件或根 Web.config 文件中显式配置的。但是，它是 .NET Framework 2.0 应用程序返回的默认配置。
| ? |  复制代码 |
|---|---|
<trace enabled="false" localOnly="true" mostRecent="false" pageOutput="false" requestLimit="10" traceMode="SortByTime" writeToDiagnosticsTrace="false" /> | |
下面的默认 element 元素是在 .NET Framework 1.0 和 1.1 版的 Machine.config 文件中配置的。
| ? | 复制代码 |
|---|---|
<trace enabled="false" localOnly="true" pageOutput="false" requestLimit="10" traceMode="SortByTime" /> | |
示例
下面的代码示例演示如何指定跟踪配置设置。
| ? | 复制代码 |
|---|---|
<configuration>
<system.web>
<trace enabled="true"
pageOutput="true"
requestLimit="15"
mostRecent="true" />
<system.web>
</configuration> | |
元素信息
|
配置节处理程序 |
|
|
配置成员 |
TraceSection |
|
可配置的位置 |
Machine.config 根级别的 Web.config 应用程序级别的 Web.config 虚拟或物理目录级别的 Web.config |
|
要求 |
Microsoft Internet 信息服务 (IIS)?5.0、5.1 或 6.0 .NET Framework 版本 1.0、1.1 或 2.0 Microsoft Visual Studio 2003 或 Visual Studio 2005 |
请参见
任务
参考
system.web 元素（ASP.NET 设置架构）configuration 元素（常规设置架构）
概念
其他资源
常规配置设置 (ASP.NET)
ASP.NET 配置设置
