TraceSection 类
配置 ASP.NET 代码跟踪服务。
语法
class TraceSection : ConfigurationSection
方法
下表列出了 TraceSection 类公开的方法。
| 名称 | 描述 |
|---|---|
| GetAllowDefinition | （继承自 ConfigurationSection。） |
| GetAllowLocation | （从 ConfigurationSection 继承。） |
| RevertToParent | （从 ConfigurationSection 继承。） |
| SetAllowDefinition | （从 ConfigurationSection 继承。） |
| SetAllowLocation | （从 ConfigurationSection 继承。） |
属性
下表列出了 TraceSection 类公开的属性。
| 名称 | 描述 |
|---|---|
Enabled |
一个可选的读/写 boolean 值。 如果为 ASP.NET 应用程序启用了跟踪，则为 true；否则为 false。 默认为 false。启用跟踪后，可以使用 URL http://<servername>/<applicationroot>/trace.axd 处的 Trace.axd 查看器查看记录的错误。 必须将 Enabled 属性设置为 true 才能使用查看器。 注意：默认情况下，Trace.axd 会添加到 Applicationhost.config 文件的 <httpHandlers> 部分。 |
LocalOnly |
一个可选的读/写 boolean 值。 如果只能在主机 Web 服务器上使用跟踪查看器 (Trace.axd)，则为 true；如果可以从任何计算机使用跟踪查看器，则为 false。 默认为 true。 |
Location |
（继承自 ConfigurationSection。）一个键属性。 |
MostRecent |
一个可选的读/写 boolean 值。 如果跟踪存储继续收集最新跟踪消息，并在达到 RequestLimit 中指定的限制时开始丢弃较旧的跟踪消息，则为 true；如果跟踪存储在达到 RequestLimit 中指定的数量时停止收集跟踪消息，则为 false。 默认为 false。 注意：此属性是 .NET Framework 2.0 中的新属性。 |
PageOutput |
一个可选的读/写 boolean 值。 如果将跟踪信息添加到每个网页的底部，则为 true；如果只能通过跟踪实用工具访问跟踪输出，则为 false。 默认为 false。 注意：有关 ASP.NET 跟踪查看器实用工具的详细信息，请参阅如何：使用跟踪查看器查看 ASP.NET 跟踪信息。 |
Path |
（继承自 ConfigurationSection。）一个键属性。 |
RequestLimit |
一个可选的读/写 sint32 值，指定要存储在服务器上的跟踪请求数（从 0 到 10000）。 默认值为 10。 如果达到限制且 MostRecent 属性为 false，则跟踪将会停止。 注意：虽然 RequestLimit 属性接受 0 到 2147483647 范围内的整数值，但如果指定的值大于 10000，ASP.NET 会自动将其向下舍入为 10000。 |
SectionInformation |
（从 ConfigurationSection 继承。） |
TraceMode |
一个可选的读/写 sint32 值，指定跟踪信息的显示顺序。 后文的“备注”部分列出了可能的值。 |
WriteToDiagnosticsTrace |
一个可选的读/写 boolean 值。 如果 ASP.NET 跟踪消息将转发到注册为显示跟踪消息的侦听器的 System.Diagnostics 跟踪基础结构，则为 true；否则为 false。 默认为 false。 注意：此属性是 .NET Framework 2.0 中的新属性。 |
子类
此类不包含子类。
注解
下表列出了 TraceMode 属性的可能值。 默认值为 1 (SortByTime)。
| 值 | 关键字 | 说明 |
|---|---|---|
| 1 | SortByTime |
指定跟踪信息按照其处理顺序显示。 |
| 2 | SortByCategory |
指定跟踪信息根据页面或服务器控制代码的 System.Web.TraceContext.Warn 和 System.Web.TraceContext.Write 方法调用中指定的用户定义类别按字母顺序显示。 |
继承层次结构
TraceSection
要求
| 类型 | 描述 |
|---|---|
| 客户端 | - IIS 7.0（在 Windows Vista 上） - IIS 7.5（在 Windows 7 上） - IIS 8.0（在 Windows 8 上） - IIS 10.0（在 Windows 10 上） |
| 服务器 | - IIS 7.0（在 Windows Server 2008 上） - IIS 7.5（在 Windows Server 2008 R2 上） - IIS 8.0（在 Windows Server 2012 上） - IIS 8.5（在 Windows Server 2012 R2 上） - IIS 10.0（在 Windows Server 2016 上） |
| 产品 | - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0 |
| MOF 文件 | WebAdministration.mof |
另请参阅
System.Web.TraceContextConfigurationSection 类
trace 元素（ASP.NET 设置架构）
如何：为 ASP.NET 页面启用跟踪
System.Web.TraceContext 方法