Элемент clear для элемента configSections (схема общих параметров)
Удаляет все ссылки на унаследованные разделы и группы разделов, оставляя только разделы и группы разделов, добавленные текущими элементами section и sectionGroup.
<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>
Сведения об элементе
Обработчик раздела конфигурации |
Не применяется. |
Элемент конфигурации |
|
Настраиваемые расположения |
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 |
См. также
Ссылки
Элемент configSections (схема общих параметров)
Элемент sectionGroup для элемента configSections (схема общих параметров)
Элемент section для элемента configSections (схема общих параметров)
Элемент remove для элемента configSections (схема общих параметров)
Элемент configuration (схема общих параметров)
Основные понятия
Иерархия и наследование файла конфигурации ASP.NET
Изменение файлов конфигурации ASP.NET
Другие ресурсы
Общие параметры конфигурации (ASP.NET)
Параметры конфигурации ASP.NET