Podelement remove elementu configSections (obecné schéma nastavení)

Článek
08/11/2011

Odebere odkaz na zděděný oddíl a skupinu oddílů.

<remove 
   name="section name" 
/>

Atributy a prvky

Následující části popisují atributy, podřízené prvky a rodičovské prvky.

v případě vícehodnotových atributů

Atribut	Popis
name	Požadované String atributu. Určuje název oddílu nebo skupiny oddílů pro odebrání. To je stejné jako atribut name elementů section nebo sectionGroup, který přidává odkaz.

Podřízené prvky

Žádný

Nadřazené prvky

Prvek	Popis
configuration	Určuje požadovaný kořenový element nacházející se v každém konfiguračním souboru, který je používán modulem CLR (Common Language Runtime) a aplikacemi rozhraní .NET Framework.
configSections	Určuje oddíl konfigurace a deklarace oboru názvů.
sectionGroup	Definuje vztah mezi obslužnou rutinou oddílu konfigurace a konfiguračním oddílem.

Poznámky

Element remove odebere odkaz na zděděné oddíly nebo skupiny oddílů. Nové oddíly a skupiny oddílů mohou být přidány do kolekce v aktuálním konfiguračním souboru pomocí elementů section a sectionGroup.

Pokud se konfigurační soubor pokusí použít oddíl konfigurace po odebrání odkazu na obslužnou rutinu, technologie ASP.NET vyvolá chybu serveru "Neznámý konfigurační oddíl název_elementu."

Příklad

Následující příklad kódu ukazuje, jak používat element remove v konfiguračním souboru aplikace pro odebrání oddílu, který byl dříve definován v souboru Machine.config.

Následující kód souboru Machine.config deklaruje oddíl s názvem sampleSection.

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

Následující příklad konfiguračního souboru aplikace odebere oddíl sampleSection. Po odebrání nemůže aplikace načíst nastavení, která jsou v sampleSection. Pokud se konfigurační soubor pokusí použít oddíl konfigurace po odebrání odkazu na obslužnou rutinu, technologie ASP.NET vyvolá chybu serveru "Neznámý konfigurační oddíl název_elementu."

<configuration>
   <configSections>
      <clear/>
      <section name="anotherSection"
               type="System.Configuration.NameValueSectionHandler" />
    </configSections>
</configuration>

Informace prvku

Obslužná rutina konfiguračního oddílu	Nelze aplikovat.
Konfigurační člen	Remove(String) Remove(String)
Konfigurovatelná umístění	Machine.config Web.config kořenové úrovně Web.config aplikační úrovně Soubor web.config na úrovni fyzického nebo virtuálního adresáře
Požadavky	Microsoft Internet Information Services (IIS) 5.0, 5.1 nebo 6.0 .NET Framework, verze 1.0, 1.1 nebo 2.0 Microsoft Visual Studio 2003 nebo Visual Studio 2005

Viz také

Sdílet prostřednictvím

Podelement remove elementu configSections (obecné schéma nastavení)

Atributy a prvky

v případě vícehodnotových atributů

Podřízené prvky

Nadřazené prvky

Poznámky

Příklad

Informace prvku

Viz také

Odkaz

Koncepty

Další zdroje

Další materiály