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

Článek
08/11/2011

Odebere všechny odkazy na zděděné oddíly a skupiny oddílů s tím, že povolí pouze ty oddíly a skupiny oddílů, které jsou přidány pomocí aktuálních elementů section a sectionGroup.

<clear />

Atributy a prvky

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

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

Žádný

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 clear odebere všechny odkazy na zděděné oddíly a skupiny oddílů s tím, že povolí pouze ty oddíly a skupiny oddílů, které jsou přidány pomocí aktuálních 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 element_name."

Příklad

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

Následující kód ze souboru Machine.config deklaruje dvě sekce, sampleSection a anotherSampleSection, které jsou přečteny před konfiguračním souborem aplikace.

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

Následující kód z konfiguračního soubor aplikace vymaže všechny dříve deklarované oddíly. Aplikace nemůže používat nebo načíst nastavení z obou oddílů, které byly deklarovány v souboru Machine.config. Aplikace však může použít nastavení z anotherSection, protože anotherSection je po elementu 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	Clear() Clear()
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 clear 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