TraceContextRecord Classe

  • Riferimento

Definizione

Spazio dei nomi:
System.Web
Assembly:
System.Web.dll

Rappresenta un messaggio di traccia di ASP.NET ed eventuali dati associati.

public ref class TraceContextRecord sealed
public sealed class TraceContextRecord
type TraceContextRecord = class
Public NotInheritable Class TraceContextRecord
Ereditarietà
Object
TraceContextRecord

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 TraceContextRecord oggetti tramite la TraceRecords proprietà, li esegue e li scrive 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>

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

L'oggetto TraceContextRecord incapsula il messaggio di traccia, la categoria, qualsiasi oggetto associato Exceptione se il record di traccia è stato scritto dal TraceContext.Warn metodo .

Ogni chiamata ai TraceContext.Write metodi e TraceContext.Warn genera un TraceContextRecord oggetto aggiunto alla TraceContextEventArgs.TraceRecords raccolta messaggi. È possibile accedere alla raccolta di record gestendo l'evento TraceFinished .

Costruttori

TraceContextRecord(String, String, Boolean, Exception)

Inizializza una nuova istanza della classe TraceContextRecord.

Proprietà

Category

Ottiene la categoria definita dall'utente per il record di traccia.
ErrorInfo

Ottiene l'oggetto Exception associato al record di traccia, se disponibile.
IsWarning

Ottiene un valore che indica se il record di traccia è associato a una chiamata al metodo Warn.
Message

Ottiene il messaggio di traccia definito dall'utente.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a

Vedi anche