Практическое руководство. Создание файлов Web.config

Visual Studio 2010

Обновлен: Ноябрь 2007

ASP.NET использует иерархию текстовых XML-файлов, каждый из которых называется Web.config, для хранения параметров, определяющих работу данного веб-узла. Используя возможности системы конфигурации ASP.NET, можно задать конфигурацию всего сервера, приложения ASP.NET или отдельных страниц. Этот раздел описывает создание файла Web.config в Visual Web Developer.

Создание файла Web.config

  1. В Обозревателе решений нажмите иконку Обновить, чтобы убедиться, что файл для данного приложения еще не существует Web.config.

    Если вы уже использовали средства администрирования веб-узлов или какие-либо другие средства настройки приложения, то файл Web.config мог быть создан автоматически. Нажатие иконки Обновить обновляет список файлов.

  2. В Обозревателе решений щелкните правой кнопкой мыши на имени веб-узла и нажмите кнопку Добавить новый элемент.

  3. В окне Шаблоны нажмите Файл веб-конфигурации.

    Именем файла в текстовом поле Имя должно быть Web.config. Это имя устанавливается по умолчанию и его можно изменить. Расширение имени файла .config защищено от загрузки ASP.NET.

  4. Нажмите Добавить, чтобы создать файл и открыть его для редактирования.

    Файл содержит код, показанный в пункте "Пример" далее в этом разделе, имеющий ряд начальных значений. Приложение наследует все параметры конфигурации из файлов Machine.config и Web.config в каталоге %SystemRoot%\Microsoft.NET\Framework\<version>\CONFIG, но здесь вы не увидите этих заданных по умолчанию параметров. Файлы Web.config уровня приложения или каталога могут создаваться только при необходимости переопределить наследуемые параметры по умолчанию или для добавления элементов коллекции, таких как Элемент httpHandlers (схема параметров ASP.NET).

    Для просмотра всех параметров конфигурации для текущего приложения можно запустить код, входящий в раздел Пошаговое руководство. Программный обзор наследуемых и локальных конфигурационных параметров. Кроме того, файлы Machine.config.comments и Web.config.comments (которые также содержат полезные комментарии) можно просмотреть в каталоге %SystemRoot%\Microsoft.NET\Framework\<version>\CONFIG, однако эти два файла не содержат все параметры времени выполненияПошаговое руководство. Программный обзор наследуемых и локальных конфигурационных параметров.

  5. Если файл Web.config был изменен, сохраните его.

    Сохранение файла Web.config перезапускает приложение. Также можно использовать атрибут configSource для отдельных элементов раздела, чтобы определить вторичный файл конфигурации, который не приводит к перезапуску приложения при изменении. Дополнительные сведения см. в подразделе configSource раздела Общие атрибуты, наследуемые элементами раздела.

Чтобы использовать IntelliSense для редактирования параметров конфигурации

  1. В Visual Web Developer откройте файл Web.config.

  2. В окне редактирования расположите курсор внутри тегов <system.web> </system.web> в строке, но не внутри других тегов.

  3. Напечатайте знак < для начала нового элемента.

    Появляется раскрывающийся список с элементами, которые могут быть добавлены в эту точку вставки. Также для вывода раскрывающегося списка можно нажать Ctrl+J вместо того, чтобы печатать знак <.

  4. Выберите элемент anonymousIdentification.

    Элемент Элемент anonymousIdentification (схема параметров ASP.NET) размещается в файле Web.config и закрывается. Если элемент закрывается при помощи закрывающего тега, то есть доступные дочерние элементы, которые можно установить. Если элемент закрывается следующим образом anonymousIdentification, то доступных дочерних элементов, которые можно установить, нет.

    <anonymousIdentification />
    
  5. Расположите курсор внутри тега <anonymousIdentification /> и нажмите клавишу ПРОБЕЛ.

    Появляется раскрывающийся список с атрибутами, которые могут быть добавлены к элементу anonymousIdentification. Чтобы не нажимать кнопку ПРОБЕЛ для вывода раскрывающегося списка, можно нажать комбинацию Ctrl+J.

  6. Выберите элемент enabled.

    Атрибут enabled размещается в файле Web.config, а поскольку этот атрибут является логическим, то значения true и false выводятся в раскрывающемся списке.

  7. Выберите пункт false. Это же значение используется системой по умолчанию.

    Система IntelliSense предлагает варианты элементов и атрибутов, которые могут быть размещены в точке вставки. Иногда специализированные атрибуты не предлагаются. При конфигурации элемента providers, так же как и при Элемент siteMap (схема параметров ASP.NET) различные инструменты и функции редактора зависят от используемого представления редактора, а так же от типа добавляемого поставщика. Система IntelliSense не показывает эти атрибуты, поскольку они зависят от значения атрибута type.

  8. Измените значение атрибута enabled на "falsex", которое является недопустимым.

    Система IntelliSense выполняет проверку и подчеркивает волнистой линией любой недопустимый текст.

В следующем примере кода показывается начальное содержимое файла Web.config, созданного посредством Visual Web Developer. Для элементов compilation и authentication задаются параметры по умолчанию. Чтобы активировать отладку ASP.NET, следует изменить атрибут debug элемента compilation на true. Все элементы, которые могут находиться внутри элемента system.web, описаны в Параметры конфигурации ASP.NET.

<?xml version="1.0"?>
<!-- 
    Note: As an alternative to hand editing this file you can use the 
    Web Site Administration Tool to configure settings for your application. Use
    the Web site->Asp.Net Configuration option in Visual Studio.
    A full list of settings and comments can be found in 
    machine.config.comments usually located in 
    \Windows\Microsoft.Net\Framework\v2.x\Config 
-->
<configuration xmlns="http://schemas.microsoft.com/.NetConfiguration/v2.0">
    <appSettings/>
    <connectionStrings/>
    <system.web>
        <!-- 
            Set compilation debug="true" to insert debugging 
            symbols into the compiled page. Because this 
            affects performance, set this value to true only 
            during development.
        -->
        <compilation debug="false"/>
        <!--
            The <authentication> section enables configuration 
            of the security authentication mode used by 
            ASP.NET to identify an incoming user. 
        -->
        <authentication mode="Windows"/>
        <!--
            The <customErrors> section enables configuration 
            of what to do if/when an unhandled error occurs 
            during the execution of a request. Specifically, 
            it enables developers to configure html error pages 
            to be displayed in place of a error stack trace.

        <customErrors mode="RemoteOnly" defaultRedirect="GenericErrorPage.htm">
            <error statusCode="403" redirect="NoAccess.htm"/>
            <error statusCode="404" redirect="FileNotFound.htm"/>
        </customErrors>
        -->
    </system.web>
</configuration>

При сохранении конфиденциальных сведений в файле конфигурации приложения следует зашифровать конфиденциальные значения, используя защищенную конфигурацию. Более подробную информацию об этом и других вопросах безопасности файлов конфигураций см. в Настройка обеспечения безопасности ASP.NET.

Показ: