Export (0) Print
Expand All

TraceContextEventArgs.TraceRecords Property

Note: This property is new in the .NET Framework version 2.0.

Gets a collection of TraceContextRecord messages that are associated with the current request.

Namespace: System.Web
Assembly: System.Web (in system.web.dll)

public ICollection TraceRecords { get; }
/** @property */
public ICollection get_TraceRecords ()

public function get TraceRecords () : ICollection

Property Value

A collection of trace records that are associated with the current request.

Every call to the System.Web.TraceContext.Write and System.Web.TraceContext.Warn methods generates a TraceContextRecord object that is added to the TraceRecords messages collection. The Warn method call sets the IsWarning property to true, while the other method calls set it to false.

You can iterate through the TraceRecords messages and examine records with specific categories or messages, and whether they are warnings.

TopicLocation
Walkthrough: Using Tracing in Visual Web Developer to Help Find Web Page ErrorsBuilding ASP .NET Web Applications in Visual Studio

The following code example demonstrates how you can register a TraceContextEventHandler delegate to handle the TraceFinished event. In this example, the OnTraceFinished method accesses the collection of TraceContextRecord objects through the TraceRecords property, iterates through them, and writes them to the response stream.

<%@ 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>

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0

Community Additions

ADD
Show:
© 2015 Microsoft