Элемент trace (схема параметров ASP.NET)
[Этот раздел из предварительной документации может быть изменен в будущих выпусках. Пустые разделы включены как заполнители.]
Позволяет настраивать службу трассировки кода ASP.NET, которая управляет сбором, хранением и выводом результатов трассировки.
<trace
enabled="true|false"
localOnly="true|false"
pageOutput="true|false"
requestLimit="integer"
mostRecent="true|false"
writeToDiagnosticsTrace="true|false"
traceMode="SortByTime|SortByCategory"
/>
Атрибуты и элементы
В следующих разделах описаны атрибуты, дочерние элементы и родительские элементы.
Атрибуты
Атрибут |
Описание |
---|---|
enabled |
Необязательный атрибут элемента Boolean. Определяет, включена ли трассировка для приложения. Чтобы использовать средство просмотра Trace.axd, трассировка должна быть включена. По умолчанию средство просмотра Trace.axd добавляется к элементу httpHandlers . Значение по умолчанию — false. |
localOnly |
Необязательный атрибут элемента Boolean. Указывает, что средство просмотра трассировки (Trace.axd) доступно только на веб-сервере, который является хостом. При значении false средство просмотра доступно с любого компьютера. По умолчанию средство просмотра Trace.axd добавляется к элементу httpHandlers . Значение по умолчанию — true. |
mostRecent |
Необязательный атрибут элемента Boolean. Указывает, будут ли отображаться самые последние данные трассировки уровня приложения и удаляться предыдущие данные трассировки, выходящие за указанные границы requestLimit. При значении false данные трассировки по запросам будут отображаться до достижения значения атрибута requestLimit . Этот атрибут не использовался до .NET Framework версии 2.0. Значение по умолчанию — false. |
pageOutput |
Необязательный атрибут элемента Boolean. Определяет, отображаются ли выходные данные трассировки в конце каждой страницы. При значении false данные трассировки доступны только из утилиты трассировки. Значение по умолчанию — false. |
requestLimit |
Необязательный атрибут элемента Int32. Задает число хранимых на сервере запросов трассировки. Когда атрибут mostRecent имеет значение false и достигается граничное значение, трассировка автоматически отключается. Максимальный предел количества запросов равен 10 000. Если указано значение, превышающее 10 000, ASP.NET округляет его до 10 000 без уведомления. Значение по умолчанию: 10. |
traceMode |
Необязательный атрибут элемента TraceDisplayMode. Определяет порядок вывода сведений трассировки. Атрибут traceMode может принимать одно из следующих значений.
ЗначениеОписание
SortByCategory Задает отображение данных трассировки в алфавитном порядке по категории, определяемой пользователем.
SortByTime Задает отображение данных трассировки в том порядке, в котором они обрабатывались.
Значение по умолчанию: SortByTime. |
writeToDiagnosticsTrace |
Необязательный атрибут элемента Boolean. Указывает, что сообщения трассировки ASP.NET направляются в инфраструктуру трассировки System.Diagnostics для любых прослушивателей, которые зарегистрированы для отображения сообщений Trace. Дополнительные сведения см. в описании элемента trace элемента system.diagnostics. Этот атрибут не использовался до .NET Framework версии 2.0. Значение по умолчанию — false. |
Дочерние элементы
Отсутствует.
Родительские элементы
Элемент |
Описание |
---|---|
configuration |
Обязательный корневой элемент любого файла конфигурации, используемого средой CLR и приложениями .NET Framework. |
system.web |
Задает корневой элемент для параметров конфигурации ASP.NET в файле конфигурации и содержит элементы конфигурации, предназначенные для настройки веб-приложений ASP.NET и управления их работой. |
Заметки
Когда трассировка включена, каждый запрос страницы создает сообщение трассировки, которое может быть добавлено к выводу страницы или храниться в журнале трассировки приложения. Можно использовать программу просмотра трассировки ASP.NET (Trace.axd) для просмотра отображения журнала трассировки. По умолчанию средство просмотра Trace.axd добавляется к элементу httpHandlers .
Примечание
Как правило, не следует включать трассировку на действующем веб-узле, так как при этом любой, кто просматривает страницы, может получить закрытые данные о конфигурации веб-узла.Трассировка используется только для отладки.Если атрибутlocalOnly имеет значение true, то результаты трассировки можно просмотреть только по запросам с локального хоста (localhost).Кроме того, если в файле Web.config задан параметр <deployment retail=true>, то трассировка отключена.
Для инструментирования готовых построений можно использовать свойства и методы класса Trace. Инструментирование позволяет отслеживать состояние приложения в реальных условиях. С помощью трассировки можно выделять проблемы и устранять их, не прерывая работу системы.
Чтобы включить трассировку, необходимо перекомпилировать приложение с установленным флагом трассировки. Для этого в строке конфигурации для языкового компилятора, который должен поддерживать трассировку, нужно установить атрибут compilerOptions в значение ="/d:TRACE". См. раздел Элемент <compiler>
Конфигурация по умолчанию
Следующий установленный по умолчанию элемент trace не задается явно ни в файле Machine.config, ни в корневом файле Web.config. Однако данное приложение в .NET Framework версии 2.0 или более поздней версии возвращает эту конфигурацию по умолчанию.
<trace
enabled="false"
localOnly="true"
mostRecent="false"
pageOutput="false"
requestLimit="10"
traceMode="SortByTime"
writeToDiagnosticsTrace="false"
/>
Следующий элемент trace по умолчанию задается в файле Machine.config для платформы .NET Framework версий 1.0 и 1.1.
<trace
enabled="false"
localOnly="true"
pageOutput="false"
requestLimit="10"
traceMode="SortByTime"
/>
Пример
В следующем примере демонстрируется задание параметров конфигурации для трассировки.
<configuration>
<system.web>
<trace enabled="true"
pageOutput="true"
requestLimit="15"
mostRecent="true" />
<system.web>
</configuration>
Сведения об элементе
Обработчик раздела конфигурации |
|
Член конфигурации |
|
Настраиваемые расположения |
Machine.config Файл Web.config корневого уровня Файл Web.config уровня приложения Файл Web.config уровня виртуального или физического каталога |
Требования |
Microsoft IIS версии 5.0 или более поздней версии Платформа .NET Framework Microsoft Visual Studio |
См. также
Задачи
How to: View Trace Information with the Trace Viewer
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
Reference
Элемент system.web (схема параметров ASP.NET)
Элемент configuration (схема общих параметров)
Основные понятия
ASP.NET Configuration File Hierarchy
Другие ресурсы
Общие параметры конфигурации (ASP.NET)
Параметры конфигурации ASP.NET