Questa documentazione è stata archiviata e non viene gestita.

Proprietà TraceContextEventArgs.TraceRecords

Ottiene un insieme di messaggi TraceContextRecord associati alla richiesta corrente.

Spazio dei nomi: System.Web
Assembly: System.Web (in system.web.dll)

public ICollection TraceRecords { get; }
/** @property */
public ICollection get_TraceRecords ()

public function get TraceRecords () : ICollection

Non applicabile.

Valore proprietà

Insieme di record di analisi associati alla richiesta corrente.

Ogni chiamata dei metodi System.Web.TraceContext.Write e System.Web.TraceContext.Warn genera un oggetto TraceContextRecord che viene aggiunto all'insieme dei messaggi TraceRecords. La chiamata al metodo Warn imposta la proprietà IsWarning su true, mentre le chiamate dell'altro metodo la imposta su false.

È possibile scorrere i messaggi della proprietà TraceRecords ed esaminare i record con categorie o messaggi specifici, nonché verificare se si tratta di avvisi.

Nell'esempio di codice riportato di seguito viene illustrato come registrare un delegato TraceContextEventHandler per gestire l'evento TraceFinished. In questo esempio, tramite il metodo OnTraceFinished si accede all'insieme di oggetti TraceContextRecord attraverso la proprietà TraceRecords, si scorrono gli oggetti, che vengono quindi scritti nel flusso di 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>

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile per Pocket PC, Windows Mobile per Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 è supportato in Windows Vista, Microsoft Windows XP SP2 e Windows Server 2003 SP1.

.NET Framework

Supportato in:
Mostra: