Обзор настройки Microsoft ASP.NET

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

Первым в настроечных файлах идет раздел <configSections>. Он содержит объявления обработчиков разделов настроек для последующих разделов настроек. Каждый раздел настроек связан с обработчиком, который будет обрабатывать параметры этого раздела. Каждое объявление связывает свой раздел настроек с обработчиком, который будет обрабатывать параметры этого раздела. Обработчик конфигурации – это класс, который реализует интерфейс IConfigurationSectionHandler и интерпретирует различные параметры и значения раздела настроек.

Давайте более внимательно посмотрим на одно из этих объявлений.

<?xml version="1.0" encoding="UTF-8" ?>
<configuration>
  <section name="httpRuntime" type=
    "System.Web.Configuration.HttpRuntimeConfigurationHandler,
    System.Web, Version=1.0.3300.0, Culture=neutral,
    PublicKeyToken=b03f5f7f11d50a3a" />

Запись name= ... указывает имя, которое будет использоваться при объявлении раздела в настроечном файле. В нашем примере это имя httpRuntime. Запись type = ... указывает обработчик, который будет обрабатывать данный раздел и интерпретировать его значения. В нашем примере обработчиком является класс System.Web.Configuration.HttpRuntimeConfigurationHandler. Запись type = ... – это информация GAC, требуемая для нахождения правильного класса.

Внутри <configSections> объявлены группы разделов. Вы можете видеть, что несколько объявлений объединены в следующую группу разделов.

<sectionGroup name="system.web">
    <section name="httpRuntime" type=
      "System.Web.Configuration.HttpRuntimeConfigurationHandler,
      System.Web, Version=1.0.3300.0, Culture=neutral,
      PublicKeyToken=b03f5f7f11d50a3a" />
    <section name="compilation" type=
      "System.Web.Configuration.CompilationConfigurationHandler,
      System.Web, Version=1.0.3300.0, Culture=neutral,
      PublicKeyToken=b03f5f7f11d50a3a" />
  </sectionGroup>

<system.web>
  <httpRuntime executionTimeout="5000" maxRequestLength="4096"
    useFullyQualifiedRedirectUrl="false" minFreeThreads="8"
    minLocalRequestFreeThreads="4" appRequestQueueLimit="100" />
  <compilation debug="false" explicit="true" defaultLanguage="vb"
    strict="false" batch="true" batchTimeout="15"
    maxBatchSize="1000" maxBatchGeneratedFileSize="3000"
    numRecompilesBeforeAppRestart="15">
  </compilation>
</system.web>

  <httpRuntime executionTimeout="5000" maxRequestLength="4096"
    useFullyQualifiedRedirectUrl="false" minFreeThreads="8"
    minLocalRequestFreeThreads="4" appRequestQueueLimit="100" />

Это означает, что разделы httpRuntime и compilation должны располагаться в группе разделов system.web. Обработчики объявлений подробно описаны в лекции 2, а создание собственных обработчиков – в лекции 9.

Группы разделов

Как показано в разделе объявлений, различные разделы настроек могут объединяться в группы с целью группировки и логичной организации параметров. Это значительно облегчает чтение и понимание всего разнообразия разделов параметров. Ниже приведен пример такой группировки.

<system.web>
<httpRuntime executionTimeout="5000" maxRequestLength="4096" 
useFullyQualifiedRedirectUrl="false" minFreeThreads="8" 
minLocalRequestFreeThreads="4" appRequestQueueLimit="100" />
<compilation debug="false" explicit="true" defaultLanguage="vb" 
strict="false" batch="true" batchTimeout="15" maxBatchSize="1000"
maxBatchGeneratedFileSize="3000" numRecompilesBeforeAppRestart="15">
</compilation>
</system.web>

Различные разделы объединены внутри тегов, представляющих объявление имени группы разделов. В нашем примере разделы httpRuntime и compilation объединены в группу разделов system.web.

Разделы настроек

Разделы настроек – это основа настроечных файлов; в них задаются все настроечные параметры. Эти разделы используют имя, объявленное при объявлении обработчика раздела, и могут содержать несколько настроек, значений и подразделов. Вот раздел настроек из примера файла machine.config.

<httpRuntime executionTimeout="5000" maxRequestLength="4096" 
useFullyQualifiedRedirectUrl="false" minFreeThreads="8" 
minLocalRequestFreeThreads="4" appRequestQueueLimit="100" />

Этот раздел объединяет несколько различных параметров, таких как executionTimeout и maxRequestLength, связанных со средой выполнения HTTP. Данные параметры обрабатываются одним и тем же обработчиком настроек, указанным в области объявлений обработчиков. Имя раздела всегда представлено в "верблюжьей" нотации.

Подразделы

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

<compilation debug="false" explicit="true" defaultLanguage="vb"
    strict="false" batch="true" batchTimeout="15"
    maxBatchSize="1000" maxBatchGeneratedFileSize="3000"
    numRecompilesBeforeAppRestart="15">
    <compilers>
      <compiler language="c#;cs;csharp" extension=".cs"
        type="Microsoft.CSharp.CSharpCodeProvider, System,
        Version=1.0.3300.0, Culture=neutral,
        PublicKeyToken=b77a5c561934e089" warningLevel="1" />
      <compiler language="vb;vbs;visualbasic;vbscript" extension=
        ".vb" type="Microsoft.VisualBasic.VBCodeProvider,
        System, Version=1.0.3300.0, Culture=neutral,
        PublicKeyToken=b77a5c561934e089" />
      <compiler language="js;jscript;javascript" extension=".js"
        type="Microsoft.JScript.JScriptCodeProvider,
        Microsoft.JScript, Version=7.0.3300.0, Culture=neutral,
        PublicKeyToken=b03f5f7f11d50a3a" />
    </compilers>
  </compilation>

  <compilation debug="false" />

Именем раздела является compilation, он содержит подраздел compilers с несколькими подразделами compiler. Раздел может содержать неограниченное количество подразделов. Имена подразделов должны следовать "верблюжьей" нотации.

Параметры

Параметры конфигурации находятся либо в разделах, либо в подразделах и включают имя параметра, за которым следует знак равенства и значение, заключенное в кавычки, например:

<compilation debug="false" />

Имя раздела настроек – compilation, имя параметра – debug, а значение этого параметра устанавливается в логическое значение False (ложь).

Имена параметров почти всегда следуют "верблюжьей нотации". Значения обычно используют соглашение об именах Паскаля, но имеется пара исключений. Слова true (истина) и false (ложь) всегда пишутся строчными буквами. Значение параметра также может быть символьной строкой, такой как строка подключения к базе данных, и в этом случае оно не следует никакому стандарту на использование регистра.

Применение изменений в настроечных файлах

Когда пользователь впервые осуществляет доступ по URL, ASP.NET просматривает файл machine.config и все применимые к этой ситуации файлы web.config и определяет, какие настроечные параметры нужно применить к этому URL. Затем эта информация кэшируется, так что при следующем запросе к этому URL она будет доступна, и ее не нужно заново считывать из настроечных файлов. Когда в один из используемых настроечных файлов вносится изменение, кэшированные параметры удаляются, и при следующем обращении к этому URL процесс повторяется с самого начала.

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

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

Обзор безопасности

К файлам с расширением .config нельзя получить доступ при помощи браузера – любая попытка приведет к возникновению ошибки HTTP 403 Aсcess Denied Error (доступ запрещен). Такой же уровень безопасности используется для файлов .aspx. Очевидно, что вы не захотите делать эти файлы доступными для общественности, и такой уровень безопасности гарантирует отсутствие доступа. Поскольку посетители не смогут получить эту информацию, можно хранить в настроечных файлах строки подключения к базе данных, пароли и ключи лицензий и быть уверенным, что они защищены.

Редактирование настроечных файлов

Давайте рассмотрим, как редактировать настроечный файл. Это довольно простая процедура. Если вы уже редактировали настроечные файлы, то можете пропустить этот раздел.

Данные файлы являются файлами XML, поэтому можно вносить изменения прямо в Блокноте. В нашем примере вы должны включить трассировку для всех приложений, выполняющихся на сервере. Найдите раздел настроек trace (см. рис. 1.2).

В разделе настроек trace измените значение параметра enabled = со значения false на значение true. Это приведет к включению трассировки для всех приложений при условии, что web.config данных приложений не переопределяет этот параметр. Теперь следует сохранить настроечный файл. Изменения этого файла обнаружатся, когда пользователь в следующий раз обратится к соответствующему URL – параметры будут перекомпилированы и заново помещены в кэш.

Для внесения следующих изменений вам потребуется инструмент администрирования IIS.

При работе с Windows Server 2003 ASP.NET обрабатывает настроечные параметры, которые заданы в IIS, а не в настроечных файлах. Как сделать соответствующие изменения, описывается в лекции 8.