Изменение файлов конфигурации ASP.NET
Обновлен: Ноябрь 2007
Данные конфигурации ASP.NET хранятся в текстовых XML-файлах с именем Web.config. Файлы Web.config могут присутствовать в нескольких каталогах приложений ASP.NET. Каждый файл Web.config применяет параметры конфигурации к каталогу, в котором он хранится, и всем его дочерним каталогам. Параметры в дочерних каталогах могут выборочно переопределять или изменять параметры, заданные в родительских каталогах. Корнем иерархии конфигурации ASP.NET является файл корневой_каталог_системы\Microsoft.NET\Framework\номер_версии\CONFIG\Web.config, который содержит параметры, применяемые ко всем приложениям ASP.NET, использующим конкретную версию платформы Microsoft .NET Framework. Поскольку каждое приложение ASP.NET наследует параметры конфигурации из корневого файла Web.config, достаточно использовать файлы Web.config, в которых переопределяются параметры, которые должны отличаться от параметров по умолчанию.
Структура файла конфигурации
Каждый файл конфигурации содержит вложенные XML-теги и подтеги с атрибутами, определяющими параметры конфигурации. Все сведения конфигурации заключены между корневыми XML-тегами <configuration> и </configuration>. Данные, содержащиеся между этими тегами, разбиты на две основных области: область объявления обработчиков разделов конфигурации и область параметров разделов конфигурации. Дополнительные сведения см. в разделе Структура файла конфигурации ASP.NET (разделы и обработчики разделов).
Изменение параметров конфигурации
Поскольку параметры хранятся в текстовых XML-файлах, создавать или изменять параметры конфигурации можно следующими способами:
С помощью конфигурационного интерфейса API ASP.NET. Дополнительные сведения см. в разделе Конфигурационный интерфейс API ASP.NET.
С помощью оснастки консоли управления (MMC) ASP.NET.
С помощью средства администрирования веб-узла для приложений ASP.NET и веб-узлов. Дополнительные сведения см. в разделе Средство администрирования веб-узла ASP.NET.
С помощью текстового редактора или редактора XML для непосредственного редактирования файлов конфигурации. Дополнительные сведения о синтаксисе см. в справочных подразделах, посвященных конфигурации, в разделах Параметры конфигурации ASP.NET и Общие параметры конфигурации (ASP.NET).
Чувствительность к регистру
Поскольку теги в файле конфигурации должны соответствовать синтаксическим правилам XML, теги, подтеги и атрибуты зависят от регистра. Теги и атрибуты имеют имена с чередованием регистров. Это означает, что первый знак имени тега будет строчным, а первые буквы в словах, входящих в идущую далее последовательность сцепленных слов, будут прописными. В большинстве случаев строковые значения атрибутов имеют формат, принятый в языке Pascal. Это означает, что как первый знак, так и первые буквы в словах, входящих в идущую далее последовательность сцепленных слов, являются прописными. Исключениями являются значения true и false, которые всегда пишутся строчными буквами.
Пользовательские разделы
Инфраструктура конфигурации ASP.NET не делает предположений о типах данных конфигурации, которые поддерживаются инфраструктурой. Классы обработчиков разделов конфигурации обрабатывают все данные, содержащиеся в файлах Web.config. Можно использовать заранее определенные обработчики разделов конфигурации, поддерживаемые платформой .NET Framework, или создавать собственные обработчики для пользовательских данных конфигурации.
Дополнительные сведения о создании пользовательских типов конфигурации см. в разделе Практическое руководство. Создание пользовательских разделов конфигурации с помощью класса ConfigurationSection.
Изменение удаленных файлов конфигурации
Конфигурационный интерфейс API ASP.NET позволяет приложению изменять файлы конфигурации на удаленном компьютере. В частности, на удаленном компьютере можно изменить файл Machine.config или Web.config в любом приложении IIS или его дочерних каталогах. Если файл Web.config отсутствует, возвращаемые данные конфигурации полностью состоят из унаследованных параметров, относящихся к указанному пути. Если приложение запрашивает обновление возвращенных данных конфигурации, создается новый файл. Дополнительные сведения см. в разделах Редактирование удаленных файлов конфигурации ASP.NET и Практическое руководство. Удаленный доступ и изменение файлов конфигурации ASP.NET.
Изменения в конфигурации приводят к перезапуску домена приложения
Изменения в параметрах конфигурации в файлах Web.config косвенно приводят к перезапуску домена приложения. Такое поведение определяется инфраструктурой. При необходимости можно использовать атрибут configSource для ссылки на внешние файлы конфигурации, не приводящие к перезапуску после внесения изменений. Дополнительные сведения см. в подразделе, посвященном атрибуту configSource, в разделе Общие атрибуты, наследуемые элементами раздела.
Попытка изменения файла конфигурации без соответствующих разрешений на его редактирование не приведет к перезапуску домена приложения.
Дополнительные сведения см. в разделе Управление изменениями параметров конфигурации.
См. также
Задачи
Практическое руководство. Удаленный доступ и изменение файлов конфигурации ASP.NET
Основные понятия
Настройка обеспечения безопасности ASP.NET
Редактирование удаленных файлов конфигурации ASP.NET
Управление изменениями параметров конфигурации