Элемент remove для элемента configSections (схема общих параметров)
Обновлен: Ноябрь 2007
Удаляет ссылку на унаследованный раздел и группу разделов.
Элемент configuration (схема общих параметров)
Элемент configSections (схема общих параметров)
Элемент remove для элемента configSections (схема общих параметров)
Элемент configuration (схема общих параметров)
Элемент configSections (схема общих параметров)
Элемент sectionGroup для элемента configSections (схема общих параметров)
Элемент remove для элемента configSections (схема общих параметров)
<remove name="section name" />
Атрибуты и элементы
В следующих разделах описаны атрибуты, дочерние и родительские элементы.
Атрибуты
Атрибут |
Описание |
|---|---|
name |
Обязательный атрибут String. Задает имя удаляемого раздела или группы разделов. Идентичен атрибуту name элемента section или sectionGroup , на который была добавлена ссылка. |
Дочерние элементы
Отсутствуют.
Родительские элементы
Элемент |
Описание |
|---|---|
configuration |
Задает обязательный корневой элемент любого файла конфигурации, используемого средой CLR и приложениями .NET Framework. |
configSections |
Задает раздел конфигурации и объявления пространств имен. |
sectionGroup |
Определяет связь между обработчиком раздела конфигурации и разделом конфигурации. |
Заметки
Элемент remove удаляет ссылки на унаследованные разделы и группы разделов. Добавить новые разделы и группы разделов в коллекцию текущего файла конфигурации можно, используя элементы section и sectionGroup.
При попытке использовать соответствующий раздел файла конфигурации после удаления ссылки на обработчик в ASP.NET выдается ошибка сервера "Нераспознанный раздел конфигурации element_name".
Пример
В следующем примере кода показан способ использования элемента remove в файле конфигурации приложения для удаления разделов, ранее определенных в файле Machine.config.
В коде следующего файла Machine.config объявляется раздел sampleSection.
<configuration>
<configSections>
<section name="sampleSection"
type="System.Configuration.SingleTagSectionHandler" />
</configSections>
<sampleSection setting1="Value1" setting2="value two"
setting3="third value" />
</configuration>
В следующем примере файла конфигурации приложения раздел sampleSection удаляется. После удаления параметры из раздела sampleSection не могут быть извлечены приложением. При попытке использовать соответствующий раздел файла конфигурации после удаления ссылки на обработчик в ASP.NET выдается ошибка сервера "Нераспознанный раздел конфигурации element_name".
<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 |
См. также
Основные понятия
Иерархия и наследование файла конфигурации ASP.NET
Изменение файлов конфигурации ASP.NET
Ссылки
Элемент configSections (схема общих параметров)
Элемент sectionGroup для элемента configSections (схема общих параметров)
Элемент section для элемента configSections (схема общих параметров)
Элемент clear для элемента configSections (схема общих параметров)
Элемент configuration (схема общих параметров)
Другие ресурсы
Общие параметры конфигурации (ASP.NET)
Параметры конфигурации ASP.NET