TraceContext.TraceFinished Event

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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 TraceFinished As TraceContextEventHandler

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.

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="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>

.NET Framework
Available since 2.0
Return to top
Show: