configSections için sectionGroup Ögesi (Genel Ayarlar Şeması)

Makale
08/01/2011

Yapılandırma bölümü işleyicisi ve yapılandırma bölümü arasındaki ilişkiyi tanımlar.

<sectionGroup 
   name="section name"
   type="configuration section handler class, assembly file name, version, culture, public key token">
   <section />
/>

Öznitelikler ve Öğeler

Öznitelikler, alt ve üst ögeler aşağıdaki bölümlerde açıklanmaktadır.

Öznitelikler

Öznitelik	Açıklama
name	Gerekli String özniteliği. type özniteliği tarafından belirtilen yapılandırma bölümü işleyicisi ile ilişkili yapılandırma bölümünün veya ögenin adını belirtir. Bu, yapılandırma dosyasının bölüm ayarları alanında göründüğü gibi group ögesinin adıdır.
type	Gerekli String özniteliği. name özniteliğinde belirtilen bölüm veya ögedeki yapılandırma ayarlarını işlemeyi idare eden yapılandırma bölümü işleyici sınıf adını belirtir. Aşağıdaki biçimi kullanın: type="Tam yetkili sınıf adı, derleyici dosya adı, sürüm, kültür, ortak anahtar belirteci" Tanımın derleme başvurusuyla eşleşmesi gerekir. Örneğin, aşağıdaki kod örneğindeki sürüm numarası derleme ile eşleşmezse hata oluşur. `type="MyConfigSectionHandler.MyHandler,MyCustomConfigurationHandler,Version=1.0.0.0,Culture=neutral,PublicKeyToken=null"` Derleme dosyası, onu tanımlayan Web.config dosyası gibi aynı uygulama dizininde yer almalıdır. Kök Web.config veya Machine.config dosyasının durumunda, derleme dosyasının %SystemRoot%\Microsoft.NET\Framework\version dizininde bulunması gerekir.

Öznitelik

Açıklama

name

Gerekli String özniteliği.

type özniteliği tarafından belirtilen yapılandırma bölümü işleyicisi ile ilişkili yapılandırma bölümünün veya ögenin adını belirtir. Bu, yapılandırma dosyasının bölüm ayarları alanında göründüğü gibi group ögesinin adıdır.

type

Gerekli String özniteliği.

name özniteliğinde belirtilen bölüm veya ögedeki yapılandırma ayarlarını işlemeyi idare eden yapılandırma bölümü işleyici sınıf adını belirtir. Aşağıdaki biçimi kullanın:

type="Tam yetkili sınıf adı, derleyici dosya adı, sürüm, kültür, ortak anahtar belirteci"

Tanımın derleme başvurusuyla eşleşmesi gerekir. Örneğin, aşağıdaki kod örneğindeki sürüm numarası derleme ile eşleşmezse hata oluşur.

type="MyConfigSectionHandler.MyHandler,MyCustomConfigurationHandler,Version=1.0.0.0,Culture=neutral,PublicKeyToken=null"

Derleme dosyası, onu tanımlayan Web.config dosyası gibi aynı uygulama dizininde yer almalıdır. Kök Web.config veya Machine.config dosyasının durumunda, derleme dosyasının %SystemRoot%\Microsoft.NET\Framework\version dizininde bulunması gerekir.

Alt Öğeler

Öge	Açıklama
section	Yapılandırma bölümü işleyicisi ve yapılandırma ögesi arasındaki ilişkiyi tanımlar.
sectionGroup	Yapılandırma bölümü işleyicisi ve yapılandırma bölümü arasındaki ilişkiyi tanımlar.

Üst Öğeler

Öge	Açıklama
configuration	Ortak dil çalıştırma modülü ile .NET Framework uygulamaları tarafından kullanılan bütün yapılandırma dosyalarında yer alması gereken kök ögeyi belirtir.
configSections	Yapılandırma bölümü ve isim uzayı bildirimi belirtir.
sectionGroup	Yapılandırma bölümü işleyicisi ve yapılandırma bölümü arasındaki ilişkiyi tanımlar.

Açıklamalar

sectionGroup ögesi section ögeleri için kapsayıcı olarak davranır. Bir section ögesi, yapılandırma bölümü işleyicisini yapılandırma ögesi veya bölümü ile ilişkilendirir. Bu, ASP.NET yapılandırma dosyasının içinde ayarların nasıl idare edileceği hakkında hiçbir varsayımda bulunmadığı için gereklidir. Bunun yerine, ASP.NET yapılandırma bölümü işleyicileri için yapılandırma verilerini işlemeyi destekler. Her section ögesi, yapılandırma bölümü veya ögesi ve yapılandırma bölümü veya ögesi işleyen ilişkili ConfigurationSection sınıfından türetilmiş sınıfı tanıtır. section ögeleri section ögelerini düzenlemek ve adlandırma çakışmalarını önlemek için sectionGroup ögelerinde mantıksal olarak gruplandırılabilir. section ve sectionGroup ögeleri configSections ögesinde yer alır.

Varsayılan Yapılandırma

.NET yapılandırma ögeleri için yapılandırma bölümleri, Machine.config dosyasında tanımlanmıştır ve sayısı burada listelemek için fazladır. Aşağıdaki Machine.config dosyası alıntısı, system.web bölümünün authentication ögesi için yapılandırma bölümü işleyicisi tanımlar. Sonra, yapılandırma ayarları authentication ögesi için tanımlanır.

Yapılandırma bölümü işleyicisi yapılandırma ögesi ile ilişkili değilse, ASP.NET "Tanımlanamayan yapılandırma bölümü öğe_adı." sunucu hatasını verir.

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

Örnek

Aşağıdaki kod örneğinde, bir bölüm grubunun ve bölüm grubu içindeki bölümlerin nasıl bildirileceği gösterilmektedir.

<configuration>
   <configSections>
      <sectionGroup name="mySectionGroup">
         <section name="mySection"
            type="System.Configuration.NameValueSectionHandler" />
      </sectionGroup>
   </configSections>
   <mySectionGroup>
      <mySection>
         <add key="key1" value="value1" />
      </mySection>
   </mySectionGroup>
</configuration>

Öğe Bilgileri

Yapılandırma bölümü işleyicisi	Uygulanmaz.
Yapılandırma üyesi	ConfigurationSectionGroup
Yapılandırılabilir konumlar	Machine.config Kök düzeyinde Web.config Uygulama düzeyinde Web.config Sanal veya fiziksel dizin düzeyinde Web.config
Gereksinimler	Microsoft Internet Information Services (IIS) sürüm 5.0, 5.1 veya 6.0 .NET Framework sürüm 2.0 Microsoft Visual Studio 2003 veya Visual Studio 2005

Ayrıca bkz.

Aracılığıyla paylaş