Udostępnij za pośrednictwem

Wyczyść elementu configSections (schemat ustawień ogólne)

  • Artykuł

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Usuwa wszystkie odwołania do sekcji dziedziczone i grup sekcji, umożliwiając sekcje i grupy sekcji, które są dodawane przez bieżący sekcji i sectionGroup elementy.

<clear />

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty i elementy podrzędne elementy nadrzędne.

Atrybuty

Brak.

Elementy podrzędne

Brak.

Elementy nadrzędne

Element

Opis

configuration

Określa element główny wymagane w każdym pliku konfiguracyjnym, który jest używany przez aparatu plików wykonywalnych języka wspólnego oraz.NET Framework aplikacji.

configSections

Określa deklaracji konfiguracji w sekcji i obszaru nazw.

sectionGroup

Definiuje skojarzenie między obsługi sekcji konfiguracji i sekcji konfiguracji.

Uwagi

clear Element usuwa wszystkie odwołania do sekcji dziedziczone i grup sekcji, umożliwiając sekcje i grupy sekcji, które są dodawane przez bieżący sekcji i sectionGroup elementy.

Jeśli plik konfiguracyjny próbuje użyć sekcji konfiguracji, po usunięciu odwołanie obsługi ASP.NET problemy błąd serwera "Nierozpoznany sekcji konfiguracji element_name."

Przykład

Poniższy przykład kodu pokazuje, jak używać clear elementu w pliku konfiguracyjnym aplikacji, aby wyczyścić sekcji, które zostały uprzednio zdefiniowane w pliku Machine.config.

Poniższy kod z pliku Machine.config deklaruje dwie sekcje, sampleSection i anotherSampleSection, które są odczytywane przed pliku konfiguracyjnego aplikacji.

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

Poniższy kod z pliku konfiguracji aplikacji powoduje wyczyszczenie wszystkich poprzednio zadeklarowanych sekcje. Aplikacja nie może używać lub pobrać ustawień w jednej sekcji, które zostały zadeklarowane w pliku Machine.config. Jednakże, to aplikacja może użyć ustawień z anotherSection ponieważ anotherSection po clear element.

<configuration>

<configSections>

<clear/>

<section name="anotherSection"

type="System.Configuration.NameValueSectionHandler" />

</configSections>

</configuration>

Informacje o elementach

Program obsługi sekcji konfiguracji

Nie stosuje się.

Członkowskie konfiguracji

Clear()

Clear()

Lokalizacje konfigurowalne

Machine.config

Web.config na poziomie katalogu głównego

Poziom aplikacji Web.config

Directory–level wirtualnego lub fizycznego Web.config

Wymagania

Microsoft Internet Information Services (IIS) w wersji 5.0, 5.1 lub 6.0

.NET Framework w wersji 1.0, 1.1 lub 2.0

Microsoft Visual Studio 2003 lub Visual Studio 2005

Zobacz też

Informacje

configSections Element (schemat ustawień ogólne)

sectionGroup elementu dla configSections (schemat ustawień ogólne)

sekcja elementu dla configSections (schemat ustawień ogólne)

Usuń Element dla configSections (schemat ustawień ogólne)

Konfiguracja elementu (schemat ustawień ogólne)

Koncepcje

ASP.NET Configuration File Hierarchy

Format of ASP.NET Configuration Files

Configuration Inheritance

Inne zasoby

Ogólne ustawienia konfiguracji (ASP.(NET)

ASP.NET ustawienia konfiguracji

ASP.NET Configuration Files

Configuring ASP.NET Applications

ASP.NET Configuration API