Freigeben über

Aktivieren der Ablaufverfolgung für eine Seite

  • Artikel

Mit Hilfe des Trace-Attributs der @ Page-Direktive können Sie steuern, ob die Ablaufverfolgung für eine Seite aktiviert oder deaktiviert ist. Wenn Sie die Ablaufverfolgung aktivieren und die Seite angefordert wird, fügt ASP.NET unabhängig davon, ob Meldungen in das Ablaufverfolgungsprotokoll geschrieben werden, eine Reihe von Tabellen mit Leistungsdaten über die Seitenanforderung an.

Standardmäßig ist die Ablaufverfolgung deaktiviert. Wenn Sie einer Seite kein Trace-Attribut hinzufügen, werden keine Ablaufverfolgungsinformationen erfasst, und die von Ihnen geschriebenen Ablaufverfolgungsanweisungen werden auf der Seite nicht angezeigt.

So aktivieren Sie die Ablaufverfolgung für eine Seite

  1. Fügen Sie am Anfang der ASPX-Datei eine @ Page-Direktive ein. Schließen Sie das Trace-Attribut ein, und setzen Sie den Wert auf true.

    <%@ Page Trace="true" %>

    Hinweis   Wenn für eine Seite die Ablaufverfolgung aktiviert ist, werden die Ablaufverfolgungsinformationen in jedem Browser angezeigt, der eine Anforderung für die Seite an den Server sendet. Die Ablaufverfolgung zeigt vertrauliche Daten an, z. B. die Werte von Servervariablen, und kann daher ein Sicherheitsrisiko darstellen. Achten Sie darauf, dass die Seitenablaufverfolgung für die Seite deaktiviert wird, bevor die Anwendung auf einen Produktionsserver portiert wird. Legen Sie dazu für das Trace-Attribut den Wert false fest, oder entfernen Sie es.

  2. Schließen Sie optional das TraceMode-Attribut ein, um die Reihenfolge anzugeben, in der Ablaufverfolgungsmeldungen angezeigt werden sollen. Legen Sie das Attribut auf SortByTime fest, um die Meldungen in der Reihenfolge ihrer Verarbeitung anzuzeigen. Setzen Sie es auf SortByCategory, um die Meldungen nach den Kategorien zu sortieren, die in den Aufrufen der Methoden Trace.Warn und Trace.Write im Seiten- oder Serversteuerelementcode angegeben wurden.

    Wenn der folgende Beispielcode am Anfang einer Seite eingefügt wird, werden die Ablaufverfolgungsmeldungen der Seite und des darin enthaltenen Serversteuerelements nach Kategorien sortiert.

    <%@ Page Language="VB" Trace="True" TraceMode="SortByCategory" %>

Die folgende Bildschirmdarstellung zeigt eine Seite, an deren Ausgabe Ablaufverfolgungsinformationen angefügt wurden.

Seitenablaufverfolgung

Siehe auch

TraceContext-Klasse | Page-Klasse | ASP.NET-Ablaufverfolgung| @ Page | Schreiben von Ablaufverfolgungsmeldungen