sekcja elementu dla configSections (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.]

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

<section 
   name="section name"
   type="configuration section handler class, assembly file name, version, culture, public key token"
   allowDefinition= "Everywhere|MachineOnly|MachineToApplication|MachineToWebRoot" 
   allowLocation="True|False" 
   restartOnExternalChanges="True|False" 
/>

Atrybuty i elementy

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

Atrybuty

Atrybut	Opis
allowDefinition	Opcjonalny Enum atrybut. Stosuje się do programu ASP.Tylko aplikacje netto. Określa, który plik konfiguracji sekcji mogą być używane w. Ten atrybut może być jedną z następujących wartości (określone w ConfigurationAllowDefinition wyliczenie) w kolejności malejącej zakresu. WartośćOpis Everywhere Umożliwia sekcji skonfigurowane w pliku konfiguracyjnym lub katalogu: W pliku Machine.config. Konfiguracja główna Web.config. Pliku Web.config dla aplikacji. Katalog wirtualny. Fizyczne podkatalogu w aplikacji. Jeśli nie allowDefinition atrybut jest używany, Everywhere zakłada, że.Jest to wartość domyślna. MachineToApplication Umożliwia sekcji należy skonfigurować w jednym z następujących plików: W pliku Machine.config. Konfiguracja główna Web.config. Pliku Web.config dla aplikacji. To nie obejmuje plików Web.config w katalogach wirtualnych lub fizyczne podkatalog w aplikacji. MachineToWebRoot Umożliwia sekcji należy skonfigurować w jednym z następujących plików: W pliku Machine.config. Konfiguracja główna Web.config. Zarówno Machine.config, jak i głównego pliku Web.config pliki znajdują się w %SystemRoot%\Microsoft.NET\Framework\numer_wersji\CONFIG. MachineOnly Umożliwia sekcji należy skonfigurować tylko w pliku Machine.config, który znajduje się w %SystemRoot%\Microsoft.NET\Framework\numer_wersji\CONFIG.
allowExeDefinition	Opcjonalny Enum atrybut. Dotyczy.NET Framework tylko aplikacje klienckie. Określa, który plik konfiguracji sekcji mogą być używane w. Ten atrybut może być jedną z następujących wartości (określone w ConfigurationAllowExeDefinition wyliczenie) w kolejności malejącej zakresu. WartośćOpis MachineToApplication Umożliwia sekcji należy skonfigurować w jednym z następujących plików: W pliku Machine.config. Konfiguracja aplikacji. MachineToRoamingUser MachineToLocalUser MachineOnly Umożliwia sekcji należy skonfigurować tylko w pliku Machine.config, który znajduje się w %SystemRoot%\Microsoft.NET\Framework\numer_wersji\CONFIG.
allowLocation	Opcjonalny Boolean atrybut. Stosuje się do programu ASP.Tylko aplikacje netto. Określa, czy sekcja może być używany w ramach lokalizację element. Wartością domyślną jest True.
name	Wymagane String atrybut. Określa nazwę sekcji konfiguracji lub element, który jest skojarzony z obsługi sekcji konfiguracji, która jest określona w type atrybut. Jest to nazwa elementu, wyświetlaną w obszarze Ustawienia sekcji pliku konfiguracyjnego.
restartOnExternalChanges	Opcjonalny Boolean atrybut. Nie stosuje się do programu ASP.NET firmy Microsoft. Określa, czy należy ponownie uruchomić aplikacji, jeśli zmienią się dane konfiguracji dla sekcji.
type	Wymagane String atrybut. Określa nazwę klasy programu obsługi sekcji konfiguracji, która obsługuje przetwarzanie ustawień konfiguracji w sekcji lub element, który jest określony w name atrybut. Użyj następującego formatu: type="Klasa w pełni kwalifikowaną nazwę, nazwy pliku zestawu, wersji, kultury, token klucza publicznego" Definicja musi odpowiada odwołaniu do zestawu. Na przykład jeśli numer wersji w następującej składni przykładu jest niezgodna z zestawu, wystąpi błąd. `type="MyConfigSectionHandler.MyHandler,MyCustomConfigurationHandler,Version=1.0.0.0,Culture=neutral,PublicKeyToken=null"` Plik zestawu musi znajdować się w tym samym katalogu aplikacji jako pliku Web.config, który definiuje plik zestawu. W odniesieniu do głównego pliku Web.config lub pliku Machine.config, plik zestawu musi być w %SystemRoot%\Microsoft.NET\Framework\wersji.

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

A section element kojarzy obsługi sekcji konfiguracji z elementu konfiguracji lub sekcji. 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 skojarzonej klasy, która wywodzi się z ConfigurationSection , obsługi sekcji konfiguracji lub element. section Elementy można grupować logicznie w sectionGroup elementów dla organizacji i aby uniknąć konfliktów nazw. section i sectionGroup elementy są zawarte w configSections element.

Domyślna konfiguracja

Konfiguracja sekcji dla.NET Framework konfiguracji 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 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 sposób definiowania sekcji konfiguracji niestandardowej i określić 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	ConfigurationSection
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) 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