Элемент configuration (схема общих параметров)
Обязательный корневой элемент любого файла конфигурации, используемого средой CLR и приложениями .NET Framework.
<configuration xmlns="schema URL">
<!-- configuration settings -->
</configuration>
Атрибуты и элементы
В следующих разделах описаны атрибуты, дочерние и родительские элементы.
Атрибуты
Атрибут |
Описание |
|---|---|
xmlns |
Необязательный атрибут элемента String. Задает URL-адрес схемы XML, которая используется для проверки файла конфигурации. Если данный атрибут не установлен, то невозможно использовать справку F1 в Microsoft Visual Studio для открытия разделов элементов конфигурации. Значение по умолчанию для ASP.NET версии 2.0 "https://schemas.microsoft.com/.NetConfiguration/v2.0". |
Дочерние элементы
Элемент |
Описание |
|---|---|
configSections |
Задает раздел конфигурации и объявления пространств имен. |
appSettings |
Содержит пользовательские параметры приложения, такие как пути к файлам, URL-адреса веб-служб XML и другие сведения, хранимые в INI-файле приложения. |
connectionStrings |
Задает для приложений и функций ASP.NET коллекцию строк подключения к базам данных в виде пар имя-значение. |
location |
Указывает ресурс, к которому применяются дочерние параметры конфигурации. Данный элемент также блокирует параметры конфигурации, предотвращая переопределение параметров конфигурации дочерними файлами конфигурации. |
Все элементы в схеме конфигурации ASP.NET. |
|
Все элементы в схеме параметров запуска. |
|
Все элементы в схеме параметров среды выполнения. |
|
Все элементы в схеме параметров удаленного взаимодействия. |
|
Все элементы в схеме параметров сети. |
|
Все элементы в схеме параметров криптографии. |
|
Все элементы в схеме разделов конфигурации. |
|
Все элементы в схеме параметров трассировки и отладки. |
|
Все элементы в схеме параметров веб-служб. |
Родительские элементы
Отсутствуют.
Заметки
Элемент configuration является обязательным корневым элементом любого файла конфигурации, используемого средой CLR и приложениями .NET Framework.
Каждый файл конфигурации должен содержать только один элемент configuration.
Конфигурация по умолчанию
В следующем примере кода показан основной файл Web.config, который можно создать для любого приложения ASP.NET. Раздел customErrors используется в случае необходимости и в данном примере закомментирован.
<?xml version="1.0"?>
<configuration
xmlns="https://schemas.microsoft.com/.NetConfiguration/v2.0">
<appSettings/>
<connectionStrings/>
<system.web>
<compilation debug="false"/>
<authentication mode="Windows"/>
<!--
<customErrors mode="RemoteOnly" defaultRedirect="GenericErrorPage.htm">
<error statusCode="403" redirect="NoAccess.htm"/>
<error statusCode="404" redirect="FileNotFound.htm"/>
</customErrors>
-->
</system.web>
</configuration>
Сведения об элементе
Обработчик раздела конфигурации |
Не применяется. |
Элемент конфигурации |
|
Настраиваемые расположения |
Machine.config Файл Web.config корневого уровня Файл Web.config уровня приложения Файл Web.config уровня виртуального или физического каталога |
Требования |
Microsoft IIS версии 5.0, 5.1 или 6.0 .NET Framework версии 1.0, 1.1 или 2.0 Microsoft Visual Studio 2003 или Visual Studio 2005 |
См. также
Задачи
Практическое руководство. Доступ к параметрам конфигурации ASP.NET программными средствами
Ссылки
Элемент configSections (схема общих параметров)
Элемент appSettings (схема общих параметров)
Элемент connectionStrings (схема параметров ASP.NET)
Элемент location (схема параметров ASP.NET)
Основные понятия
Общие сведения о конфигурационном ASP.NET
Настройка обеспечения безопасности ASP.NET
Изменение файлов конфигурации ASP.NET
Другие ресурсы
Общие параметры конфигурации (ASP.NET)
Параметры конфигурации ASP.NET
Администрирование веб-сайта ASP.NET