Элемент configuration (схема общих параметров)
Обновлен: Ноябрь 2007
Обязательный корневой элемент любого файла конфигурации, используемого средой 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 программными средствами
Основные понятия
Общие сведения о конфигурационном ASP.NET
Настройка обеспечения безопасности ASP.NET
Изменение файлов конфигурации ASP.NET
Ссылки
Элемент configSections (схема общих параметров)
Элемент appSettings (схема общих параметров)
Элемент connectionStrings (схема параметров ASP.NET)
Элемент location (схема параметров ASP.NET)
Другие ресурсы
Общие параметры конфигурации (ASP.NET)
Параметры конфигурации ASP.NET
Администрирование веб-узлов ASP.NET