configSections Element (schemat ustawień ogólne)

Artykuł
06/25/2012

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

Określa deklaracji konfiguracji w sekcji i obszaru nazw.

   <configSections>
      <section />
      <sectionGroup />
      <remove />
      <clear/>
   </configSections>

Atrybuty i elementy

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

Atrybuty

Brak.

Elementy podrzędne

Element	Opis
clear	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.
remove	Usuwa odwołanie do sekcji dziedziczone i grupy sekcji.
section	Definiuje skojarzenie między obsługi sekcji konfiguracji i element konfiguracji.
sectionGroup	Definiuje skojarzenie między obsługi sekcji konfiguracji i sekcji konfiguracji.

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.

Uwagi

configSections Element określa konfiguracji sekcji i obsługi deklaracji. Jest to wymagane, ponieważ program ASP.NET sprawia, że nie założeń dotyczących sposobu obsługi ustawień w pliku konfiguracji. Zamiast tego ASP.NET deleguje przetwarzania danych konfiguracji obsługi sekcji konfiguracji.

Każdy section identyfikuje element w sekcji konfiguracji lub element i związanych z nimi ConfigurationSection-klasy, która obsługi sekcji konfiguracji lub element. section Elementy można grupować logicznie w sectionGroup elementy do organizowania section elementów oraz w celu uniknięcia konfliktów nazw. section i sectionGroup elementy są zawarte w configSections element.

Jeśli configSections element znajduje się w pliku konfiguracji, configSections element musi być pierwszym elementem dziecko configuration element.

Domyślna konfiguracja

Konfiguracja sekcji dla.Elementy konfiguracji netto są zdefiniowane w pliku Machine.config i są zbyt liczne, aby wyświetlić listę tutaj. Poniższy fragment pliku Machine.config definiuje obsługi sekcji konfiguracji authentication elementu system.web sekcji. Następnie, ustawienia konfiguracji są zdefiniowane dla authentication element.

Jeśli program obsługi sekcji konfiguracji nie jest skojarzony z elementem konfiguracji ASP.NET problemy błąd serwera "Nierozpoznany sekcji konfiguracji element_name."

<configuration>
    <configSections>
        <sectionGroup name="system.web" type="System.Web.Configuration.SystemWebSectionGroup, System.Web, Version=%ASSEMBLY_VERSION%, Culture=neutral, PublicKeyToken=%MICROSOFT_PUBLICKEY%">
            <section name="authentication" type="System.Web.Configuration.AuthenticationSection, System.Web, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" allowDefinition="MachineToApplication" />
            <!-- Other system.web sections -->
        </sectionGroup>
        <!-- Other configuration sections -->
    </configSections>

    <system.web>
        <authentication mode="Windows">
            <forms name=".ASPXAUTH" 
                   loginUrl="login.aspx" defaultUrl="default.aspx" 
                   protection="All" 
                   timeout="30" 
                   path="/" 
                   requireSSL="False" 
                   slidingExpiration="True" 
                   cookieless="UseCookies" 
                   domain="" 
                   enableCrossAppRedirects="False">
                <credentials passwordFormat="SHA1" />
            </forms>
            <passport redirectUrl="internal" />
        </authentication>
        <!-- Other system.web elements -->
    </system.web>
    <!-- Other configuration settings -->
</configuration>

Przykład

Poniższy przykład kodu pokazuje jak zdefiniować sekcji konfiguracji niestandardowych i ustawienia dla tej sekcji.

<configuration>

   <configSections>
      <section name="sampleSection"
               type="System.Configuration.SingleTagSectionHandler" />
   </configSections>

   <sampleSection setting1="Value1" 
                  setting2="value two" 
                  setting3="third value" />

</configuration>

Informacje o elementach

Program obsługi sekcji konfiguracji	Nie stosuje się.
Członkowskie konfiguracji	ConfigurationSectionCollection ConfigurationSectionGroupCollection
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ż

Udostępnij za pośrednictwem