Podelement remove elementu configSections (obecné schéma nastavení)
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 |
|
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é
Odkaz
Element configSections (Obecné schéma nastavení)
Podelement sectionGroup elementu configSections (obecné schéma nastavení)
Podelement section elementu configSections (obecné schéma nastavení)
Podelement clear elementu configSections (obecné schéma nastavení)
Element configuration (schéma obecného nastavení)
Koncepty
Hierarchie a dědičnost konfiguračních souborů technologie ASP.NET
Úpravy souborů konfigurace technologie ASP.NET
Scénáře konfigurace technologie ASP.NET
Další zdroje
Obecné nastavení konfigurace (technologie ASP.NET)