TraceContextEventArgs.TraceRecords Vlastnost

Definice

Obor názvů:

System.Web

Sestavení:

System.Web.dll

Získá kolekci TraceContextRecord zpráv, které jsou přidruženy k aktuálnímu požadavku.

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

Hodnota vlastnosti

ICollection

Kolekce trasovacích záznamů, které jsou přidruženy k aktuálnímu požadavku.

Příklady

Následující příklad kódu ukazuje, jak můžete zaregistrovat delegáta TraceContextEventHandler pro zpracování TraceFinished události. V tomto příkladu OnTraceFinished metoda přistupuje ke kolekci TraceContextRecord objektů prostřednictvím TraceRecords vlastnosti, iteruje je a zapisuje je do streamu odpovědi.

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

Poznámky

Každé volání TraceContext.Write metod a TraceContext.Warn vygeneruje TraceContextRecord objekt, který je přidán do TraceRecords kolekce zpráv. Volání Warn metody nastaví IsWarning vlastnost na true, zatímco ostatní volání metody ji nastaví na false.

Můžete procházet TraceRecords zprávy a zkoumat záznamy s konkrétními kategoriemi nebo zprávami a zjistit, jestli se jedná o upozornění.

Viz také

• TraceContextRecord
• TraceContextEventHandler
• TraceContext
• Přehled trasování ASP.NET