TraceContextEventArgs.TraceRecords Eigenschaft

Referenz

Definition

Namespace:: System.Web

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft eine Auflistung von TraceContextRecord-Meldungen ab, die der aktuellen Anforderung zugeordnet sind.

public:
 property System::Collections::ICollection ^ TraceRecords { System::Collections::ICollection ^ get(); };

public System.Collections.ICollection TraceRecords { get; }

member this.TraceRecords : System.Collections.ICollection

Public ReadOnly Property TraceRecords As ICollection

Eigenschaftswert

ICollection

Eine Auflistung von Ablaufverfolgungsdatensätzen, die der aktuellen Anforderung zugeordnet sind.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie einen TraceContextEventHandler Delegaten registrieren können, um das TraceFinished Ereignis zu behandeln. In diesem Beispiel greift die OnTraceFinished -Methode über die -Eigenschaft auf die TraceRecords Auflistung von TraceContextRecord -Objekten 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

Jeder Aufruf der TraceContext.Write Methoden und TraceContext.Warn generiert ein TraceContextRecord Objekt, das der TraceRecords Nachrichtenauflistung hinzugefügt wird. Der Warn -Methodenaufruf legt die IsWarning -Eigenschaft auf fest true, während die andere Methode aufruft sie auf falsefestlegen.

Sie können die TraceRecords Nachrichten durchlaufen und Datensätze mit bestimmten Kategorien oder Nachrichten untersuchen und überprüfen, ob es sich um Warnungen handelt.

Gilt für:

Freigeben über