TraceContextEventArgs Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt eine Auflistung der Ablaufverfolgungsdatensätze für jede Methode bereit, die das TraceFinished-Ereignis behandelt. Diese Klasse kann nicht vererbt werden.
public ref class TraceContextEventArgs sealed : EventArgs
public sealed class TraceContextEventArgs : EventArgs
type TraceContextEventArgs = class
inherit EventArgs
Public NotInheritable Class TraceContextEventArgs
Inherits EventArgs
- Vererbung
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
Die TraceContextEventArgs -Klasse wird von der TraceContext -Klasse verwendet, um den Zugriff auf Ablaufverfolgungsdatensätze zu ermöglichen, nachdem alle Ablaufverfolgungsinformationen während der HTTP-Anforderungsverarbeitung erfasst wurden. Durch Hinzufügen eines Ereignishandlerdelegats zum Behandeln des TraceFinished Ereignisses können Sie die Datensätze verarbeiten, in Ihrem eigenen Datenspeicher aufzeichnen oder als Eingabe für ein Profilerstellungstool bereitstellen.
Konstruktoren
TraceContextEventArgs(ICollection) |
Initialisiert eine neue Instanz der TraceContextEventArgs-Klasse mit der bereitgestellten Auflistung von Ablaufverfolgungsdatensätzen. |
Eigenschaften
TraceRecords |
Ruft eine Auflistung von TraceContextRecord-Meldungen ab, die der aktuellen Anforderung zugeordnet sind. |
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) |