TraceContext 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.
Erfasst und stellt Ausführungsdetails zu einer Webanforderung dar. Diese Klasse kann nicht vererbt werden.
public ref class TraceContext sealed
public sealed class TraceContext
type TraceContext = class
Public NotInheritable Class TraceContext
- Vererbung
-
TraceContext
Hinweise
Sie können diese Klasse verwenden, um Nachrichten an bestimmte Ablaufverfolgungskategorien anzufügen. Wenn Sie beispielsweise eine Instanz der Calendar Klasse für Ihre Anwendung erstellen, können Sie die Ablaufverfolgungsmeldung "Starting To Render" in eine Renderingprozedur und "Raising OnChange Event" in eine Ereignishandlerprozedur einschließen.
Sie können die TraceContext Klasse auch verwenden, um eine Reihe von Ablaufverfolgungsdatensätzen am Ende der Anforderungsausführung für die benutzerdefinierte Verarbeitung abzurufen. Weitere Informationen finden Sie unter ASP.NET Übersicht über die Ablaufverfolgung.
Um die Ablaufverfolgung zu aktivieren, legen Sie das Trace Attribut in der @Page-Direktive oder der IsEnabled Eigenschaft auf true. Wenn die Ablaufverfolgung aktiviert ist, umfasst die Page Klasse neben der Anzeige von vom Benutzer bereitgestellten Ablaufverfolgungsinhalten automatisch Leistungsdaten, Strukturinformationen zur Steuerelementstruktur und Zustandsverwaltungsinhalte für jede Anforderung.
Konstruktoren
| Name | Beschreibung |
|---|---|
| TraceContext(HttpContext) |
Initialisiert eine neue Instanz der TraceContext-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| IsEnabled |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Ablaufverfolgung für die aktuelle Webanforderung aktiviert ist. |
| TraceMode |
Ruft die sortierte Reihenfolge ab, in der Ablaufverfolgungsmeldungen in einen anfordernden Browser ausgegeben werden sollen, oder legt diese fest. |
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) |
| Warn(String, String, Exception) |
Schreibt Ablaufverfolgungsinformationen in das Ablaufverfolgungsprotokoll, einschließlich benutzerdefinierter Kategorien, Ablaufverfolgungsmeldungen und Fehlerinformationen. Alle Warnungen werden im Protokoll als roter Text angezeigt. |
| Warn(String, String) |
Schreibt Ablaufverfolgungsinformationen in das Ablaufverfolgungsprotokoll, einschließlich aller benutzerdefinierten Kategorien und Ablaufverfolgungsmeldungen. Alle Warnungen werden im Protokoll als roter Text angezeigt. |
| Warn(String) |
Schreibt eine Ablaufverfolgungsmeldung in das Ablaufverfolgungsprotokoll. Alle Warnungen werden im Protokoll als roter Text angezeigt. |
| Write(String, String, Exception) |
Schreibt Ablaufverfolgungsinformationen in das Ablaufverfolgungsprotokoll, einschließlich benutzerdefinierter Kategorien, Ablaufverfolgungsmeldungen und Fehlerinformationen. |
| Write(String, String) |
Schreibt Ablaufverfolgungsinformationen in das Ablaufverfolgungsprotokoll, einschließlich einer Nachricht und aller benutzerdefinierten Kategorien. |
| Write(String) |
Schreibt eine Ablaufverfolgungsmeldung in das Ablaufverfolgungsprotokoll. |
Ereignisse
| Name | Beschreibung |
|---|---|
| TraceFinished |
Wird vom TraceContext Objekt ausgelöst, um Ablaufverfolgungsmeldungen verfügbar zu machen, nachdem alle Anforderungsinformationen gesammelt wurden. |