TraceContextRecord 类

  • 参考

定义

命名空间:
System.Web
程序集:
System.Web.dll

表示 ASP.NET 跟踪消息和任何关联数据。

public ref class TraceContextRecord sealed
public sealed class TraceContextRecord
type TraceContextRecord = class
Public NotInheritable Class TraceContextRecord
继承
Object
TraceContextRecord

示例

下面的代码示例演示如何注册 TraceContextEventHandler 委托来处理 TraceFinished 事件。 在此示例中，OnTraceFinished方法通过 TraceRecords 属性访问对象的集合TraceContextRecord，循环访问对象集合，并将其写入响应流。

<%@ Page language="c#" Trace="true" %>
<script runat="server">
void Page_Load(object sender, EventArgs e)
{
    // Register a handler for the TraceFinished event.
    Trace.TraceFinished += new 
        TraceContextEventHandler(this.OnTraceFinished);

    // Write a trace message.
    Trace.Write("Web Forms Infrastructure Methods", "USERMESSAGE: Page_Load complete.");
}
 
// A TraceContextEventHandler for the TraceFinished event.
void OnTraceFinished(object sender, TraceContextEventArgs e)
{
    TraceContextRecord r = null;    
    
    // Iterate through the collection of trace records and write 
    // them to the response stream.
    foreach(object o in e.TraceRecords)
    {
        r = (TraceContextRecord)o;
        Response.Write(String.Format("trace message: {0} <BR>", r.Message));
    }
}       
</script>

<%@ Page language="VB" Trace="true" %>
<script runat="server">
' The Page_Load method.
Private Sub Page_Load(sender As Object, e As EventArgs)

    ' Register a handler for the TraceFinished event.
    AddHandler Trace.TraceFinished, AddressOf OnTraceFinished

    ' Write a trace message.
    Trace.Write("Web Forms Infrastructure Methods", "USERMESSAGE: Page_Load complete.")
End Sub ' Page_Load
 
' A TraceContextEventHandler for the TraceFinished event.
Private Sub OnTraceFinished(sender As Object, e As TraceContextEventArgs)

    Dim r As TraceContextRecord
    Dim o As Object
    
    ' Iterate through the collection of trace records and write 
    ' them to the response stream.

    For Each o In e.TraceRecords
        r = CType(o, TraceContextRecord)
        Response.Write(String.Format("trace message: {0} <BR>", r.Message))
    Next

End Sub ' OnTraceFinished
</script>

注解

对象 TraceContextRecord 封装跟踪消息、类别、任何关联的 Exception以及跟踪记录是否由 TraceContext.Warn 方法写入。

每次调用 TraceContext.Write 和 TraceContext.Warn 方法都会生成一个 TraceContextRecord 对象，该对象将添加到消息集合中 TraceContextEventArgs.TraceRecords 。 可以通过处理 TraceFinished 事件来访问记录集合。

构造函数

TraceContextRecord(String, String, Boolean, Exception)

初始化 TraceContextRecord 类的新实例。

属性

Category

获取跟踪记录的用户定义的类别。
ErrorInfo

获取与跟踪记录关联的 Exception（如果有）。
IsWarning

获取一个值，该值指示跟踪记录是否与 Warn 方法调用关联。
Message

获取用户定义的跟踪消息。

方法

Equals(Object)

确定指定对象是否等于当前对象。

(继承自 Object)
GetHashCode()

作为默认哈希函数。

(继承自 Object)
GetType()

获取当前实例的 Type。

(继承自 Object)
MemberwiseClone()

创建当前 Object 的浅表副本。

(继承自 Object)
ToString()

返回表示当前对象的字符串。

(继承自 Object)

适用于

另请参阅