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

  • Статья

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

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

Сводка

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

Добавление параметров конфигурации в 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 и все вложенные папки.

Ссылки