TraceContextRecord Klasse

Definition

public ref class TraceContextRecord sealed

public sealed class TraceContextRecord

type TraceContextRecord = class

Public NotInheritable Class TraceContextRecord

Vererbung

Object

TraceContextRecord

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie einen TraceContextEventHandler Delegaten für die Behandlung des TraceFinished Ereignisses registrieren können. In diesem Beispiel greift die OnTraceFinished Methode auf die Auflistung von TraceContextRecord Objekten über die TraceRecords Eigenschaft zu, durchläuft sie und schreibt sie in den Antwortdatenstrom.

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

Hinweise

Das TraceContextRecord Objekt kapselt die Ablaufverfolgungsmeldung, kategorie, alle zugeordneten ExceptionElemente und ob der Ablaufverfolgungsdatensatz von der TraceContext.Warn Methode geschrieben wurde.

Jeder Aufruf der TraceContext.Write Und TraceContext.Warn Methoden generiert ein TraceContextRecord Objekt, das der TraceContextEventArgs.TraceRecords Nachrichtenauflistung hinzugefügt wird. Sie können auf die Sammlung von Datensätzen zugreifen, indem Sie das TraceFinished Ereignis behandeln.

Weitere Informationen

• TraceContextEventArgs
• TraceContextEventHandler
• Übersicht über die ASP.NET-Ablaufverfolgung
• Vorgehensweise: Aktivieren der Ablaufverfolgung für eine ASP.NET Seite