Поделиться через


Элемент 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

Все элементы в схеме конфигурации ASP.NET.

Схема параметров запуска

Все элементы в схеме параметров запуска.

Схема параметров среды выполнения

Все элементы в схеме параметров среды выполнения.

Схема параметров удаленного взаимодействия

Все элементы в схеме параметров удаленного взаимодействия.

Схема параметров сети

Все элементы в схеме параметров сети.

Схема параметров криптографии

Все элементы в схеме параметров криптографии.

Схема разделов конфигурации

Все элементы в схеме разделов конфигурации.

Схема параметров трассировки и отладки

Все элементы в схеме параметров трассировки и отладки.

Схема параметров веб-служб XML

Все элементы в схеме параметров веб-служб.

Родительские элементы

Отсутствуют.

Заметки

Элемент 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>

Сведения об элементе

Обработчик раздела конфигурации

Не применяется.

Элемент конфигурации

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

Сценарии конфигурации ASP.NET

Ссылки

Элемент configSections (схема общих параметров)

Элемент appSettings (схема общих параметров)

Элемент connectionStrings (схема параметров ASP.NET)

Элемент location (схема параметров ASP.NET)

Другие ресурсы

Общие параметры конфигурации (ASP.NET)

Параметры конфигурации ASP.NET

Администрирование веб-узлов ASP.NET

Конфигурационный интерфейс API ASP.NET

Файлы конфигурации