trace 元素（ASP.NET 设置架构）

项目
05/28/2012

[本文档仅供预览，在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]

配置 ASP.NET 代码跟踪服务以控制如何收集、存储和显示跟踪结果。

<trace 
   enabled="true|false"
   localOnly="true|false"
   pageOutput="true|false"
   requestLimit="integer" 
   mostRecent="true|false"
   writeToDiagnosticsTrace="true|false"
   traceMode="SortByTime|SortByCategory"
/>

特性和元素

以下几节描述了特性、子元素和父元素。

特性

特性	说明
enabled	可选的 Boolean 特性。指定是否为应用程序启用跟踪。为了使用 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	可选的 Int32 特性。指定在服务器上存储的跟踪请求的数目。如果达到限制，并且 mostRecent 特性为 false，将自动禁用跟踪。最大请求限制为 10,000。如果指定了大于 10,000 的值，ASP.NET 会在不给出任何提示的情况下将它向下舍入到 10,000。默认值为 10。
traceMode	可选的 TraceDisplayMode 特性。指定显示跟踪信息的顺序。 traceMode 特性可以为下列可能值之一。值说明 SortByCategory 指定根据用户定义的类别按字母顺序显示跟踪信息。 SortByTime 指定以处理跟踪信息的顺序来显示跟踪信息。默认值为 SortByTime。
writeToDiagnosticsTrace	可选的 Boolean 特性。指定是否将 ASP.NET 跟踪消息转发到 System.Diagnostics 跟踪基础结构，以便注册的任何侦听器显示 Trace 消息。有关更多信息，请参见 system.diagnostics 的 trace 元素。此特性是 .NET Framework 2.0 版中的新特性。默认值为 false。

子元素

无。

父元素

元素	说明
configuration	公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。
system.web	指定配置文件中 ASP.NET 配置设置的根元素，并包含用于配置 ASP.NET Web 应用程序和控制应用程序行为方式的配置元素。

备注

当启用跟踪时，每个页请求生成跟踪消息，这些跟踪消息可以被追加到页输出中或被存储到应用程序跟踪日志中。可以使用 ASP.NET 跟踪查看器 (Trace.axd) 查看跟踪日志的内容。默认情况下，Trace.axd 被添加到 httpHandlers 元素。

备注

一般来说，不应在活动网站上启用跟踪，因为这会向查看该网站页面的任何人显示敏感的配置信息。跟踪仅用于调试目的。如果 localOnly 特性为 true，则只为本地主机请求显示跟踪信息。另外，如果在 Web.config 文件中设置 <deployment retail=true>，将会禁用跟踪。

可以使用 Trace 类中的属性和方法来检测发行版本。检测使您能通过在实际设置下运行应用程序来监视应用程序的运行状况。跟踪技术可帮助您隔离和修复问题，而不中断正在运行的系统。

您需要重新编译设置了跟踪标志的应用程序才能使跟踪生效。通过以下方法执行此操作：在配置行中将希望支持跟踪的语言编译器的 compilerOptions 特性设置为 ="/d:TRACE"。引用 <compiler> 元素

默认配置

下面的默认 trace 元素不是在 Machine.config 文件或根 Web.config 文件中显式配置的。但它是 .NET Framework 2.0 及更高版本中应用程序返回的默认配置。

<trace 
   enabled="false" 
   localOnly="true" 
   mostRecent="false" 
   pageOutput="false" 
   requestLimit="10" 
   traceMode="SortByTime" 
   writeToDiagnosticsTrace="false" 
/>

下面的默认 trace 元素是在 .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
配置成员	TraceSection
可配置的位置	Machine.config 根级别的 Web.config 应用程序级别的 Web.config 虚拟或物理目录级别的 Web.config
要求	Microsoft Internet 信息服务 (IIS) 5.0 或更高版本 .NET Framework Microsoft Visual Studio

请参见

通过

trace 元素（ASP.NET 设置架构）

特性和元素

特性

子元素

父元素

备注

默认配置

示例

元素信息

请参见

任务

参考

概念

其他资源

其他资源