Udostępnij za pośrednictwem

Usuń Element dla 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 odwołanie do sekcji dziedziczone i grupy sekcji.

<remove 
   name="section name" 
/>

Atrybuty i elementy

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

Atrybuty

Atrybut

Opis

name

Wymagane String atrybut.

Określa nazwę sekcji lub grupy sekcji do usunięcia. Jest to taki sam, jak name atrybutu w sekcji lub sectionGroup element, który dodaje odniesienia.

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

remove Element Usuwa odwołanie do dziedziczonych sekcji lub grup sekcji. Nowe sekcje i grupy sekcji można można dodać do kolekcji w bieżącym pliku konfiguracji przy użyciu 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ć remove elementu w pliku konfiguracyjnym aplikacji, aby usunąć sekcję, która została wcześniej zdefiniowana w pliku Machine.config.

Poniższy kod pliku Machine.config deklaruje sekcję o nazwie sampleSection.

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

Następujący przykładowy plik konfiguracji aplikacji usuwa sampleSection sekcji. Po usunięciu, aplikacja nie może pobrać ustawień, które znajdują się w sampleSection. 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."

<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

Remove(String)

Remove(String)

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)

Wyczyść elementu 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