TraceContext 类

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

捕获并提供有关 Web 请求的执行详细信息。此类不能被继承。

public ref class TraceContext sealed

public sealed class TraceContext

type TraceContext = class

Public NotInheritable Class TraceContext

可以使用此类将消息追加到特定的跟踪类别。例如，如果要为应用程序创建类的 Calendar 实例，则可以在呈现过程中包括跟踪消息“正在开始呈现”，并在事件处理程序过程中包括“引发 OnChange 事件”。

还可以使用 TraceContext 类在请求执行结束时获取一组跟踪记录，以便进行自定义处理。有关详细信息，请参阅 ASP.NET 跟踪概述。

若要启用跟踪，请将 Trace@ Page 指令中的属性或 IsEnabled 属性设置为 true。启用跟踪后，除了显示用户提供的跟踪内容外， Page 类还会自动包括每个请求的性能数据、控制树结构信息和状态管理内容。

初始化 TraceContext 类的新实例。

IsEnabled	获取或设置用来指示是否启用对当前 Web 请求的跟踪的值。
TraceMode	获取或设置跟踪消息输出到请求浏览器应遵循的排序顺序。

Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)
Warn(String)	将跟踪消息写入跟踪日志。所有警告在日志中均显示为红色文本。
Warn(String, String)	将跟踪信息写入跟踪日志，包括任何用户定义的类别和跟踪消息。所有警告在日志中均显示为红色文本。
Warn(String, String, Exception)	将跟踪信息写入跟踪日志，包括用户定义的所有类别、跟踪消息和错误消息。所有警告在日志中均显示为红色文本。
Write(String)	将跟踪消息写入跟踪日志。
Write(String, String)	将跟踪信息写入跟踪日志，包括消息和任何用户定义的类别。
Write(String, String, Exception)	将跟踪信息写入跟踪日志，包括用户定义的所有类别、跟踪消息和错误消息。

由 TraceContext 对象引发，用于在收集完所有请求信息后公开跟踪消息。