Лекция: Конфигурирование ASP.NET. web.config
В данной статье описывается создание файла Web.config, который используется для управления поведением отдельных приложений ASP.NET.
Web.config — это файл, определяющий параметры для ASP.NET web-приложения. По сути, файл web.config — это XML-документ. В нем хранится информация о параметрах поставщиков состояний сеансов, членства, определяются ссылки на страницы ошибок. Также web.config содержит строки соединения с базами данных, средства управления трассировкой.
Параметры конфигурации на уровне системы для платформа.NET Framework определены в файле Machine.config. В файле Machine.config находится в папке %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\. Влиять на поведение приложений на всей системы могут быть изменены параметры по умолчанию, содержащиеся в файле Machine.config.
Параметры конфигурации ASP.NET для отдельного приложения можно изменить при создании файла Web.config в корневой папке приложения. При этом параметры в файле Web.config переопределяют параметры в файле Machine.config.
Как минимум файл Web.config должен содержать элемент <configuration> и <system.web> элемента. Эти элементы будут содержать индивидуальные элементы конфигурации.
В следующем примере показано минимального файла Web.config:
<?xml version=«1.0» encoding=«utf-8» ?>
<configuration>
<system.web>
</system.web>
</configuration>
Первая строка файла Web.config описание документа в формате XML и определяет тип кодировки. Первая строка должно быть одинаковым для всех файлов конфигурации.
Механизм наследования файлов конфигурации ASP.NET таков
1) Сначала применяются параметры из machine.config
2) Затем применяются параметры из файла web.config, находящемся в корневом каталоге приложения.
3) Далее, если в каком-то из каталогов приложения имеется файл web.config, то применяются параметры из него.
Также, в случае возникновения конфликтов среди параметров из файла web.config, который находится в каком-то из вложенных каталогов, параметры из вложенного каталога перекроют параметры из конфигурационного файла каталога-родителя. Однако существует исключение, которое может вызвать блокировку некоторых разделов параметров: это элемент <location>, определяющий несколько групп параметров настройки в одном конфигурационном файле.
Например:
<configuration>
<!--...-->
<system.web>
<!--...-->
</system.web>
<location path="/ExampleDirectory">
<system.web>
<!--Здесь идут параметры для подкаталога ExampleDirectory-->
</system.web>
</location>
<!--...-->
</configuration>
Такой файл web.config играет роль двух конфигурационных файлов. Таким образом можно указывать любое количество подкаталогов и их параметров.
<compilation debug=«false» />
Позволяет указать выводить или нет отладочную информацию на страницу при возникновении ошибки;
<customErrors mode=«RemoteOnly» defaultRedirect=«GenericErrorPage.htm»>
<error statusCode=«403» redirect=«NoAccess.htm» />
<error statusCode=«404» redirect=«FileNotFound.htm» />
</customErrors>
Позволяет настраивать ошибки HTTP;
<authentication mode=«Windows» />
Устанавливает способ авторизации;
<sessionState mode=«StateServer»></sessionState>
Устанавливает режим хранения сессии;
<globalization
fileEncoding=«utf-8»
requestEncoding=«utf-8»
responseEncoding=«utf-8»
culture=«ru-RU»
uiCulture=«ru-RU»
/>
Параметры глобализации.
Также в файле Web.config можно указать переменные приложения в секции appSetings
<add key=«LogDetail» value=«Debug»/>
Которые в последствии можно вызывать из кода C#
string DetailLog = ConfigurationManager.AppSettings[«LogDetail»];