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

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

  • Статья

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

Удаляет все ссылки на унаследованные разделы и группы разделов, оставляя только разделы и группы разделов, добавленные текущими элементами section и sectionGroup.

Элемент configuration (схема общих параметров)
  Элемент configSections (схема общих параметров)
    Элемент clear для элемента configSections (схема общих параметров)
      Элемент configuration (схема общих параметров)
        Элемент configSections (схема общих параметров)
          Элемент sectionGroup для элемента configSections (схема общих параметров)
            Элемент clear для элемента configSections (схема общих параметров)

<clear />

Атрибуты и элементы

В следующих разделах описаны атрибуты, дочерние элементы и родительские элементы.

Атрибуты

Нет.

Дочерние элементы

Нет.

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

Элемент

Описание

configuration

Задает обязательный корневой элемент любого файла конфигурации, используемого средой CLR и приложениями платформы .NET Framework.

configSections

Задает раздел конфигурации и объявления пространств имен.

sectionGroup

Определяет связь между обработчиком раздела конфигурации и разделом конфигурации.

Заметки

Элемент clear удаляет все ссылки на унаследованные разделы и группы разделов, оставляя только разделы и группы разделов, добавленные текущими элементами section и sectionGroup.

Если в файле конфигурации предпринимается попытка использовать раздел конфигурации после удаления ссылки на обработчик, то платформа ASP.NET выдает ошибку сервера "Нераспознанный раздел конфигурации element_name".

Пример

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

В следующем коде из файла Machine.config объявляются два раздела, sampleSection и anotherSampleSection, которые считываются перед чтением файла конфигурации приложения.

<configuration>
   <configSections>
      <section name="sampleSection"
               type="System.Configuration.SingleTagSectionHandler" />
      <section name="anotherSampleSection"
               type="System.Configuration.NameValueSectionHandler" />
   </configSections>
   <sampleSection setting1="Value1" setting2="value two" 
                  setting3="third value" />
</configuration>

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

<configuration>

<configSections>

<clear/>

<section name="anotherSection"

type="System.Configuration.NameValueSectionHandler" />

</configSections>

</configuration>

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

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

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

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

Clear()

Clear()

Настраиваемые расположения

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

Ссылки

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

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

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

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

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

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

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

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

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

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

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