sectionGroup elementu dla configSections (schemat ustawień ogólne)
[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]
Definiuje skojarzenie między obsługi sekcji konfiguracja i sekcji konfiguracja .
<sectionGroup
name="section name"
type="configuration section handler class, assembly file name, version, culture, public key token">
<section />
</sectionGroup>
Atrybuty i elementy
W poniższych sekcjach opisano atrybuty i elementy element podrzędny elementy nadrzędne.
Atrybuty
Atrybut |
Opis |
---|---|
name |
Wymagane String atrybut. Określa nazwę sekcji konfiguracja lub element, który jest skojarzony z określoną przez program obsługi sekcji konfiguracja type atrybut. Jest to nazwa group elementu w postaci, w jakiej pojawia się w sekcji Ustawienia obszar pliku konfiguracja . |
type |
Wymagane String atrybut. Określa nazwę klasy programu obsługi sekcji konfiguracja , która obsługuje przetwarzanie ustawień konfiguracja , które są w sekcji lub element, który jest określony w name atrybut. Użyj następującego formatu: type="Fully qualified nazwa klasy,zestaw nazwa pliku,version,culture,klucz publiczny token" Definicja musi odpowiada odwołaniu do zestaw . Na przykład jeśli numer wersji w następującym przykładzie kodu jest niezgodny z zestaw, wystąpi błąd.
Plik zestaw musi znajdować się w tym samym katalogu aplikacji jako plik .config sieć Web, który definiuje ją. W odniesieniu do .config korzeńwsieć Weblub pliku Machine.config, plik zestaw musi być w %SystemRoot%\Microsoft.NET\Framework\wersji katalogu. |
Elementy podrzędne
Element |
Opis |
---|---|
section |
Definiuje skojarzenie między obsługi sekcji konfiguracja i element konfiguracja . |
sectionGroup |
Definiuje skojarzenie między obsługi sekcji konfiguracja i sekcji konfiguracja . |
Elementy nadrzędne
Element |
Opis |
---|---|
configuration |
Określa element wymagane korzeń w każdym pliku konfiguracja , który jest używany przez aparat plików wykonywalnych języka wspólnego oraz.NET Framework firmy Microsoft. |
configSections |
Określa deklaracji konfiguracja w sekcji i przestrzeń nazw . |
sectionGroup |
Definiuje skojarzenie między obsługi sekcji konfiguracja i sekcji konfiguracja . |
Uwagi
sectionGroup Element działa jako kontener dla section elementy. A section element kojarzy obsługi sekcji konfiguracja z elementu konfiguracja lub sekcji. Jest to konieczne, ponieważ ASP.NET czyni nie założeń dotyczących sposobu dojście ustawień w pliku konfiguracja . Zamiast tego ASP.NET deleguje przetwarzania danych konfiguracja obsługi sekcji konfiguracja . Każdy section identyfikuje element w sekcji konfiguracja lub element i skojarzonej klasy, która wywodzi się z ConfigurationSection klasy, która obsługuje sekcji konfiguracja 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.
Domyślna konfiguracja
Konfiguracja sekcji dla.NET konfiguracja elementów 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 konfiguracja authentication elementu system.web sekcji. Następnie, ustawienia konfiguracja są zdefiniowane dla authentication element.
Jeśli program obsługi sekcji konfiguracja nie jest skojarzony z elementem konfiguracja ASP.NET problemy błąd serwera "Nierozpoznany sekcji konfiguracja 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, w jaki sposób zadeklarować sekcji grupa i zadeklarować sekcje wewnątrz grupasekcji.
<configuration>
<configSections>
<sectionGroup name="mySectionGroup">
<section name="mySection"
type="System.Configuration.NameValueSectionHandler" />
</sectionGroup>
</configSections>
<mySectionGroup>
<mySection>
<add key="key1" value="value1" />
</mySection>
</mySectionGroup>
</configuration>
Informacje o elementach
Program obsługi sekcji konfiguracji |
Nie stosuje się. |
Członkowskie konfiguracji |
|
Lokalizacje konfigurowalne |
Machine.config Poziom główny sieć Web.config Poziom aplikacji sieć Web.config .Config wirtualnego lub fizycznego directory–level w sieć Web |
Wymagania |
Microsoft Internet Information Services Internet (IIS) w wersji 5.0, 5.1 lub 6.0 .NET Framework w wersji 2.0 Microsoft Visual Studio 2003 lub Visual Studio 2005 |
Zobacz też
Informacje
configSections Element (schemat ustawień ogólne)
sekcja elementu dla configSections (schemat ustawień ogólne)
Wyczyść elementu 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
Inne zasoby
Ogólne ustawienia konfiguracji (ASP.(NET)
ASP.NET ustawienia konfiguracji