Разделы с параметрами конфигурирования

Web.config — это файл, определяющий параметры для ASP.NET web-приложения. По сути, файл web.config — это XML-документ. В нем хранится информация о параметрах поставщиков состояний сеансов, членства, определяются ссылки на страницы ошибок. Также web.config содержит строки соединения с базами данных, средства управления трассировкой.

Параметры указанные в файле web.config применяются в том каталоге в котором он находится, а также во всех дочерних каталогах относительно корневого. Файл web.config имеет удобную xml-структуру, его легко можно изменить (создать) в любом текстовом редакторе:

<configuration>

<configSection>

<!-- объявления обработчиков -->

</configSection>

<system.web>

<!-- параметры конфигурирования ASP.NET -->

</system.web>

<system.net>

<!-- параметры конфигурирования.NET Runtime -->

</system.net>

</configuration>

Раздел конфигурирования находится внутри дескрипторов <configuration>. Между дескрипторами <configSection> находятся обработчики, которые обрабатывают XML-данные, хранящиеся в файле web.config, и выдают соответствующий этим данным объект.

Между дескрипторами <system.net> находятся параметры конфигурирования системы.NET Runtime.

Параметры конфигурирования непосредственно ASP.NET находятся между дескрипторами <system.web>. Вы можете определять любые свои группы параметров конфигурирования (разделы), но обычно, разделов, предлагаемых системой ASP.NET, вполне достаточно.

Основные разделы конфигурирования

<compilation>

Раздел <compilation> позволяет задать параметры компиляции приложения. В частности, можно установить язык используемый по умолчанию в приложении и определить параметры отладки приложения.

<compilation defaultLanguage="VB" debug="true" />

По умолчанию свойство debug = "false".

<globalization>

Раздел <globalization> позволяет настроить параметры глобализации приложения. В частности, здесь можно определить кодировку входящих и исходящих данных. По умолчанию установлена кодировка - utf-8.

<globalization requestEncoding="windows-1251" responseEncoding="windows-1251" />

<appSettings>

Пожалуй, <appSettings> является наиболее часто используемым разделом, поскольку в нем вы можете определять свои атрибуты, такие как, например, строки соединения с базой данных или заголовок окна браузера. Раздел <appSettings> имеет всего один элемент – add, который в свою очередь имеет два атрибута – key и value.

<configuration>

<appSettings>

<--! <add key=“Ключ” value=“Значение”/> -->

<add key="MyTitle" value="Это мой заголовок окна"/>

<add key="MyDBPath" value="А здесь находится путь к моей базе данных"/>

</appSettings>

</configuration>

В отличии от других разделов, <appSettings> ASP.NET никак не обрабатывает и поэтому нахождение дескрипторов <appSettings> в разделе <system.web> не обязательно.

Чтобы получить указанные в <appSettings> данные, в данном случае MyTitle и/или MyDBPath, достаточно применить на ASP.NET странице свойство ConfigurationSettings.AppSettings:

Private Sub Page_Load (obj As Object, e As EventArgs)

'Отправляем в браузер строку значение ключа MyDBPath

Response.Write(ConfigurationSettings.AppSettings("MyDBPath"))

End Sub

<customErrors>

Не менее интересный раздел - <customErros>. Данный раздел позволяет указать страницу, на которую будет попадать пользователь при возникновении ошибки. Например, при возникновении 404 ошибки (Ресурс не найден), вместо стандартного сообщения об ошибке, вы можете вставить свою страницу с сообщением об ошибке.

Для примера, ниже указанная конфигурация, при возникновении 404 ошибки (ресурс не найден) перенаправит пользователя на страницу error404.html, а в случае возникновения другой ошибки – на страницу error.html:

<configuration>

<customError defaultRedirect="error.html" mode="on">

<error statuscode="404" redirect="error404.html" />

</customError>

</configuration>

<pages>

Данный раздел позволяет установить параметры страницы, которые обычно указываются в таких директивах, как - @Page. Это довольно удобно, когда требуется установить одинаковые параметры для всех страниц сразу.

<sessionState>

<sessionState> позволяет установить параметры сессии и имеет следующие атрибуты:

mode – указывает состояние сеанса, может иметь следующие значения:

off – состояние сеанса отключено;

inproc – информация о сеансе хранится локально (по умолчанию);

stateserver – информация о сеансе хранится на другом сервере;

sqlserver – информация о сеансе хранится в базе данных SQL Server.

cookieless – значение true данного параметра позволяет отключить использование сессией cookies в приложении, при этом сеанс будет сохраняться в строке адреса url.

timeout – максимальное время «жизни» сессии в режиме ожидания (по умолчанию 20 минут)

connectionString – строка соединения, содержащая имя сервера и порт для хранения сессии. Используется только при значении mode=“stateserver”.

sqlConnectionString – строка соединения с базой данных SQL Server. Используется только при значении mode=“sqlserver”.

Прочие разделы

Web.config имеет еще много разделов конфигурирования. Ниже представлена таблица со всеми разделами конфигурирования файла web.config и кратким их описанием:

<appSettings> позволяет хранить пользовательские (ваши) параметры приложения

<authorization> конфигурирует авторизацию ресурсов и позволяет настроить аутентификацию пользователей.

<browserCaps> представляет возможности браузера пользователя.

<compilation> конфигурирует параметры компиляции приложений.

<globalization> конфигурирует параметры глобализации приложения.

<httpHandlers> отвечает за передачу поступающих url классам IHttpHandler и IHttpHandlerFactory. Данные раздела <httpHandlerFactory> наследуются всеми подкаталогами.

<httpModules> позволяет настроить HTTP-модули, находящиеся внутри приложения, которые участвуют в обработке каждого запроса, поступившего в приложение.

<identity> управляет доступом к ресурсам ASP.NET.

<location> определяет права доступа к указанному каталогу.

<processModel> конфигурирует параметры модели обработки.

<sessionState> устанавливает параметры сессии.

<trace> позволяет настроить службы трассировки (отладки) системы ASP.NET.

<webServices> конфигурирует параметры web-служб.

93 Конфигурированиевеб-сайтов ASP.NET|Конфигурирование веб-сайтов ASP.NET