Freigeben über

TraceContextRecord Klasse

Definition

Namespace:
System.Web
Assembly:
System.Web.dll

Stellt eine ASP.NET Ablaufverfolgungsmeldung und alle zugehörigen Daten dar.

public ref class TraceContextRecord sealed
public sealed class TraceContextRecord
type TraceContextRecord = class
Public NotInheritable Class TraceContextRecord
Vererbung
Object
TraceContextRecord

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie einen TraceContextEventHandler Delegaten für die Behandlung des TraceFinished Ereignisses registrieren können. In diesem Beispiel greift die OnTraceFinished Methode auf die Auflistung von TraceContextRecord Objekten über die TraceRecords Eigenschaft zu, durchläuft sie und schreibt sie in den Antwortdatenstrom.

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

Das TraceContextRecord Objekt kapselt die Ablaufverfolgungsmeldung, kategorie, alle zugeordneten ExceptionElemente und ob der Ablaufverfolgungsdatensatz von der TraceContext.Warn Methode geschrieben wurde.

Jeder Aufruf der TraceContext.Write Und TraceContext.Warn Methoden generiert ein TraceContextRecord Objekt, das der TraceContextEventArgs.TraceRecords Nachrichtenauflistung hinzugefügt wird. Sie können auf die Sammlung von Datensätzen zugreifen, indem Sie das TraceFinished Ereignis behandeln.

Konstruktoren

Name Beschreibung
TraceContextRecord(String, String, Boolean, Exception)

Initialisiert eine neue Instanz der TraceContextRecord-Klasse.

Eigenschaften

Name Beschreibung
Category

Ruft die benutzerdefinierte Kategorie für den Ablaufverfolgungsdatensatz ab.
ErrorInfo

Ruft den Exception zugeordneten Ablaufverfolgungsdatensatz ab, falls vorhanden.
IsWarning

Ruft einen Wert ab, der angibt, ob der Ablaufverfolgungsdatensatz einem Warn Methodenaufruf zugeordnet ist.
Message

Ruft die benutzerdefinierte Ablaufverfolgungsnachricht ab.

Methoden

Name Beschreibung
Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für:

Weitere Informationen