This documentation is archived and is not being maintained.

TraceContextEventHandler Delegate

Represents the method that handles the TraceFinished event of a TraceContext object.

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

'Declaration
Public Delegate Sub TraceContextEventHandler ( _
	sender As Object, _
	e As TraceContextEventArgs _
)
'Usage
Dim instance As New TraceContextEventHandler(AddressOf HandlerMethod)
/** @delegate */
public delegate void TraceContextEventHandler (
	Object sender, 
	TraceContextEventArgs e
)
Not applicable.

Parameters

sender

The event source (the TraceContext).

e

A TraceContextEventArgs that contains the event data.

When you create a TraceContextEventHandler delegate, you identify the method that will handle the event. To associate the event with your event handler, add an instance of the delegate to the event. The event handler is called whenever the event occurs, unless you remove the delegate.

For more information about event handler delegates, see Events and Delegates.

The following code example demonstrates how to register a TraceContextEventHandler delegate to handle the TraceFinished event. In this example, the OnTraceFinished method iterates through the trace records and writes them to the response stream.

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

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

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0
Show: