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

Статья
08/11/2011

Удаляет ссылку на унаследованный раздел и группу разделов.

<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>

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

Обработчик раздела конфигурации	Не применяется.
Элемент конфигурации	Remove(String) Remove(String)
Настраиваемые расположения	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

См. также

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

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

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

Атрибуты

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

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

Заметки

Пример

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

См. также

Ссылки

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

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

Дополнительные ресурсы