TraceContextEventArgs.TraceRecords Proprietà

Definizione

Spazio dei nomi:

System.Web

Assembly:

System.Web.dll

Ottiene un insieme di messaggi TraceContextRecord associati alla richiesta corrente.

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

Valore della proprietà

ICollection

Insieme di record di traccia associati alla richiesta corrente.

Esempio

Nell'esempio di codice seguente viene illustrato come registrare un TraceContextEventHandler delegato per gestire l'evento TraceFinished . In questo esempio il OnTraceFinished metodo accede alla raccolta di oggetti tramite la TraceRecords proprietà , li scorre e li scrive nel flusso di TraceContextRecord risposta.

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

Commenti

Ogni chiamata ai TraceContext.Write metodi e TraceContext.Warn genera un TraceContextRecord oggetto aggiunto all'insieme TraceRecords messages. La chiamata al Warn metodo imposta la IsWarning proprietà su true, mentre l'altro metodo lo falsechiama su .

È possibile scorrere i TraceRecords messaggi ed esaminare i record con categorie o messaggi specifici e se sono avvisi.

Vedi anche

• TraceContextRecord
• TraceContextEventHandler
• TraceContext
• Cenni preliminari sulla funzionalità di traccia di ASP.NET