Практическое руководство. Включение трассировки для приложений ASP.NET

Обновлен: Ноябрь 2007

Вместо того, чтобы включать трассировку для отдельных страниц, можно включить ее для всего приложения. В этом случае все страницы приложения отображают сведения трассировки. Трассировка приложения полезна при его разработке, потому что можно легко включать и отключать трассировку при правке отдельных страниц. После завершения приложения трассировку для всех страниц можно выключить одним действием.

При включении трассировки на уровне приложения ASP.NET собирает данные о запросах (число исследуемых запросов не может превышать заданное максимальное число запросов). По умолчанию максимальное число запросов равно 10. Сведения трассировки можно просмотреть с помощью средства просмотра трассировки.

По умолчанию после достижения максимального числа запросов приложение перестает сохранять запросы трассировки. Однако можно настроить трассировку на уровне приложения таким образом, чтобы всегда сохранять самые последние данные трассировки, удаляя старые данные по достижении максимального числа запросов. Дополнительные сведения см. в разделе Application-Level Tracing Overview.

Примечание.
Чтобы отключить трассировку для отдельной страницы приложения, следует присвоить атрибуту Trace в директиве @ Page этой страницы значение false. Любой оператор Write или Warn, включенный в код страницы, хранится и возвращается только средству просмотра трассировки.

Чтобы включить трассировку на уровне приложения

1. Откройте файл Web.config веб-узла. Если файл Web.config не существует, создайте новый файл в корневой папке и скопируйте в него следующее:

   <?xml version="1.0"?>
   <configuration xmlns="https://schemas.microsoft.com/.NetConfiguration/v2.0">
     <system.web>
   
     </system.web>
   </configuration>
   

2. Добавьте элемент trace как дочерний элемент system.web.

3. В элементе trace присвойте атрибуту enabled значение true.

4. Если требуется отображать сведения трассировки в конце страницы, с которой они связаны, можно присвоить атрибуту trace элемента pageOutput значение true. Если требуется, чтобы информация трассировки выводилась только в средстве просмотра трассировки, присвойте атрибуту pageOutput значение false.

   Например, приведенные ниже параметры трассировки приложения позволяют собирать сведения о 40 запросах и просматривать их с помощью обозревателя на удаленных компьютерах. Сведения трассировки не отображаются на отдельных страницах.

   <configuration>
     <system.web>
       <trace enabled="true" pageOutput="false" requestLimit="40" localOnly="false"/>
     </system.web>
   </configuration>
   

Примечание.
В конфигурации ASP.NET учитывается регистр.

См. также

Задачи

Практическое руководство. Включение трассировки для страницы ASP.NET

Практическое руководство. Просмотр сведений о трассировке ASP.NET c помощью средства просмотра трассировки

Основные понятия

Общие сведения о конфигурационном ASP.NET

Другие ресурсы

ASP.NET Tracing

Application-Level Tracing