Изменение конфигурации приложения ASP.NET

В этой статье описывается изменение файла web.config приложения ASP.NET.

Исходная версия продукта: ASP.NET
Исходный номер базы знаний: 815178

Итоги

Файл конфигурации Web.config определяет поведение ASP.NET приложений. В платформа .NET Framework Майкрософт, включая ASP.NET, для настройки приложений используется текстовые файлы в формате XML. Это отклонение от обычных механизмов конфигурации реестра и метабазы. В настоящее время нет оснастки консоли управления Майкрософт (MMC) или другого средства администрирования, предоставленного Корпорацией Майкрософт, для создания и изменения файлов конфигурации.

Добавление параметров конфигурации в web.config

Большинство приложений ASP.NET оснащены предварительно созданным файлом web.config , который можно редактировать с помощью любого текстового редактора, например Блокнота. Как правило, файлы web.config содержат комментарии, которые делают редактирование файла самообъяснительным. Однако может потребоваться добавить элементы конфигурации в файл конфигурации Web.config , который еще не определен. Чтобы добавить стандартный элемент конфигурации в файл web.config , выполните следующие действия:

  1. Откройте файл Machine.config в текстовом редакторе, например Блокноте.

    Файл Machine.config находится в каталоге %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\ .

  2. В файле Machine.config найдите параметр конфигурации, который нужно переопределить в файле web.config. Если элемент имеет несколько строк, элемент начинается со <element_name> строки и заканчивается </element_name>на . Элемент также может быть самозаверяющей и может выглядеть примерно так же <element_name attribute1='option' attribute2='option' />. Пробелы игнорируются. Поэтому элемент может охватывать несколько строк. Элемент может предшествовать комментариев. Комментарий содержится внутри <!-- and --> маркировки. Приведенный <trace> ниже пример элемента конфигурации является примером самозаверяющего элемента. Пример <trace> элемента конфигурации содержит несколько атрибутов, охватывает несколько строк и имеет комментарий в начале.

    <!--
trace Attributes:
    enabled="[true|false]" - Enable application tracing
    localOnly="[true|false]" - View trace results from localhost only
    pageOutput="[true|false]" - Display trace output on individual pages
    requestLimit="[number]" - Number of trace results available in trace.axd
    traceMode="[SortByTime|SortByCategory]" - Sorts trace result displays based on Time or Category
 -->
<trace
    enabled="false"
    localOnly="true"
    pageOutput="false"
    requestLimit="10"
    traceMode="SortByTime"
/>

  3. Скопируйте весь элемент конфигурации и любой начальный комментарий в буфер обмена.

  4. Определите, как элемент вложен в файл Machine.config .

    Файл Machine.config является иерархическим, а элементы конфигурации вложены в другие элементы. При копировании элемента конфигурации из файла Machine.config в файл Web.config необходимо вложить этот элемент конфигурации в тот же элемент, из который он был скопирован. Чтобы определить элемент файла конфигурации Machine.config, в котором содержится элемент конфигурации, прокрутите страницу вверх в файле Machine.config, пока не найдете открытый, не закрытый элемент. Содержащий элемент прост для идентификации, так как элементы более высокого уровня имеют меньше отступов.

    Большинство элементов конфигурации ASP.NET содержатся в элементе <system.web> . Конец элемента ( </system.web> ) должен быть помещен после элемента конфигурации.

    Примечание.

    Элемент, в котором содержится элемент конфигурации. Этот элемент необходимо вставить в тот же элемент в файле web.config . Элемент конфигурации может быть вложен в несколько элементов. Необходимо создать все элементы более высокого уровня в файле web.config .

  5. Закройте файл Machine.config, а затем используйте текстовый редактор, чтобы открыть файл Web.config в корневом каталоге приложения ASP.NET.

  6. Вставьте элемент конфигурации между началом и концом элемента, который вы определили на шаге 4.

    Например, если элемент конфигурации содержится в <system.web> элементе, элемент конфигурации должен быть вставлен сразу после открытия строки <system.web> элемента и перед </system.web> закрывающей линией.

  7. Измените элемент конфигурации в файле конфигурации Web.config , чтобы переопределить параметр machine.config для этого приложения.

    Этот параметр применяется к папке, содержащей файл конфигурации Web.config и все вложенные папки.

Ссылки

  • Last updated on