This documentation is archived and is not being maintained.

TraceContext.TraceFinished Event

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

Raised by the TraceContext object to expose trace messages after all request information is gathered.

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

public event TraceContextEventHandler TraceFinished
/** @event */
public void add_TraceFinished (TraceContextEventHandler value)

/** @event */
public void remove_TraceFinished (TraceContextEventHandler value)

JScript supports the use of events, but not the declaration of new ones.

The TraceFinished event is raised during the EndRequest stage of HTTP request processing. It is raised by a TraceContext object after all request information is gathered, to expose the collection of TraceContextRecord messages to registered TraceContextEventHandler delegates.

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 to handle the TraceFinished event. In this example, the delegate iterates through the trace messages and writes them to the response stream; however, you could write the same information to a database or a profiling tool consumer.

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