Freigeben über

TraceContextRecord Klasse

  • Referenz

Definition

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

Stellt eine ASP.NET-Ablaufverfolgungsmeldung und alle zugeordneten 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 registrieren können, um das TraceFinished Ereignis zu behandeln. In diesem Beispiel greift die OnTraceFinished -Methode über die -Eigenschaft auf die TraceRecords Auflistung von TraceContextRecord Objekten 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, die Kategorie, alle zugeordneten Exceptionund ob der Ablaufverfolgungsdatensatz von der TraceContext.Warn -Methode geschrieben wurde.

Jeder Aufruf der TraceContext.Write -Methode und TraceContext.Warn der -Methode 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

TraceContextRecord(String, String, Boolean, Exception)

Initialisiert eine neue Instanz der TraceContextRecord-Klasse.

Eigenschaften

Category

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

Ruft die dem Ablaufverfolgungsdatensatz zugeordnete Exception ab, sofern diese verfügbar ist.
IsWarning

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

Ruft die benutzerdefinierte Ablaufverfolgungsmeldung ab.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

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

(Geerbt von Object)

Gilt für:

Weitere Informationen