TraceContextEventArgs.TraceRecords Eigenschaft

Definition

Ruft eine Auflistung von TraceContextRecord-Meldungen ab, die der aktuellen Anforderung zugeordnet sind.Gets a collection of TraceContextRecord messages that are associated with the current request.

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

Eine Auflistung von Ablaufverfolgungsdatensätzen, die der aktuellen Anforderung zugeordnet sind.A collection of trace records that are associated with the current request.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie einen TraceContextEventHandler Delegaten registrieren können TraceFinished , um das-Ereignis zu behandeln.The following code example demonstrates how you can register a TraceContextEventHandler delegate to handle the TraceFinished event. In diesem Beispiel greift die OnTraceFinished -Methode über die TraceRecords - TraceContextRecord Eigenschaft auf die Auflistung von-Objekten zu, durchläuft sie und schreibt Sie in den Antwortstream.In this example, the OnTraceFinished method accesses the collection of TraceContextRecord objects through the TraceRecords property, iterates through them, and writes them to the response stream.

<%@ 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-Aufrufe der TraceContext.Write - TraceContext.Warn Methode und der TraceContextRecord -Methode generiert ein-Objekt TraceRecords , das der Nachrichten Auflistung hinzugefügt wird.Every call to the TraceContext.Write and TraceContext.Warn methods generates a TraceContextRecord object that is added to the TraceRecords messages collection. Mit Warn dem-Methodenaufruf IsWarning wird die true-Eigenschaft auf festgelegt, während die anderen falseMethodenaufrufe diese auf festlegen.The Warn method call sets the IsWarning property to true, while the other method calls set it to false.

Sie können die TraceRecords Nachrichten durchlaufen und Datensätze mit bestimmten Kategorien oder Meldungen überprüfen, und ob es sich um Warnungen handelt.You can iterate through the TraceRecords messages and examine records with specific categories or messages, and whether they are warnings.

Gilt für:

Siehe auch