Общие атрибуты, наследуемые элементами раздела

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

Элементы раздела

Элементы раздела представляют собой члены разделов конфигурации. К ним не относятся элементы, входящие в группы разделов конфигурации.

Обьявления раздела конфигурации отображаются в верхней части файла конфигурации в элементе configSections. Каждое объявление, содержащееся в элементе section, задает имя раздела и имя класса .NET Framework (производного от ConfigurationSection), который обрабатывает данные конфигурации в этом разделе. Теги section можно сгруппировать в теги sectionGroup.

Дополнительные сведения см. в разделе Файлы конфигурации ASP.NET или Изменение файлов конфигурации ASP.NET.

Общие атрибуты

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

Атрибут	Описание
configSource	Необязательный атрибут элемента String. Задает имя включаемого файла, в котором определяется связанный раздел конфигурации, если такой файл существует. Программно доступен с помощью свойства ConfigSource. При использовании атрибута configSource необходимо переместить весь раздел в отдельный файл, поскольку отсутствуют процессы слияния параметров элементов. Любые изменения внешнего файла вызывают по умолчанию перезапуск приложения. Чтобы изменить это поведение и отменить перезапуск приложения после каждого изменения, в файле Web.config можно настроить элемент Элемент section для элемента configSections (схема общих параметров) и задать его атрибуту restartOnExternalChanges значение false.
lockAllAttributesExcept	Необязательный атрибут String; значение может быть в виде списка с разделителями-запятыми. Блокирует все атрибуты родительского элемента за исключением указанных. Программно доступен с помощью свойства LockAllAttributesExcept. Нижние уровни иерархии конфигурации никогда не блокируют более высокие уровни.
lockAllElementsExcept	Необязательный атрибут String; значение может быть в виде списка с разделителями-запятыми. Блокирует все дочерние элементы родительского элемента за исключением указанных. Программно доступен с помощью свойства LockAllElementsExcept.
lockAttributes	Необязательный атрибут String; значение может быть в виде списка с разделителями-запятыми. Блокирует все атрибуты родительского элемента. Программно доступен с помощью свойства LockAttributes.
lockElements	Необязательный атрибут String; значение может быть в виде списка с разделителями-запятыми. Блокирует все дочерние элементы родительского элемента. Программно доступен с помощью свойства LockElements.
lockItem	Необязательный атрибут String. Если элемент, в котором присутствует атрибут, должен быть заблокирован, значение — true; в противном случае — false. По умолчанию используется значение false. Кроме использования для блокировки отдельных элементов, этот атрибут может применяться в коллекции элементов для их специальной блокировки в указанной коллекции. Атрибут можно использовать для блокировки всего раздела. Программно доступен с помощью свойства LockItem.

Пример

Следующий пример кода является частью файла Machine.config. Обработчики раздела конфигурации объявлены для группы раздела system.web и раздела anonymousIdentification. Далее объявлены элементы конфигурации system.Web и anonymousIdentification.

Элемент конфигурации system.Web является членом группы раздела конфигурации, что означает отсутствие в нем атрибутов.

Элемент конфигурации anonymousIdentification является членом раздела конфигурации, поэтому он наследует атрибуты, ранее перечисленные в таблице. Следует обратить внимание, что его атрибуту configSource назначен внешний файл (для хранения содержимого элемента), а атрибут lockItem имеет значение true, заданное для защиты его содержимого.

<configuration>

  <configSections>
    <!-- Other configuration sections. -->
    <sectionGroup name="system.web" ...>
      <section name="anonymousIdentification" ... />
    </sectionGroup>
  </configSections>

  <system.web>
    <anonymousIdentification  configSource="IDSourceFile.xml" 
       lockItem="true" />
  </system.web>

</configuration>

См. также

Задачи

Пошаговое руководство. Отключение параметров конфигурации ASP.NET

Основные понятия

Общие сведения о конфигурационном ASP.NET

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

Настройка обеспечения безопасности ASP.NET

Изменение файлов конфигурации ASP.NET

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

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