configSections Ögesi (Genel Ayarlar Şeması)

Makale
08/01/2011

Yapılandırma bölümü ve isim uzayı bildirimi belirtir.

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

Öznitelikler ve Öğeler

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

Öznitelikler

Yok.

Alt Öğeler

Öge	Açyklama
clear	Sadece geçerli section ve sectionGroup ögeleri tarafından eklenen bölümler ve bölüm gruplarına izin vererek, devralınan bölümler ve bölüm gruplarına yapılan tüm başvuruları kaldırır.
remove	Devralınan bölüm ve bölüm grubuna yapılan başvuruyu kaldırır.
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.

Açıklamalar

configSections ögesi yapılandırma bölümünü ve işleyici bildirimlerini belirtir. 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 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.

configSections ögesi bir yapılandırma dosyasında ise, configSections ögesi configuration ögesinin ilk alt ögesi olmalıdı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 "Unrecognized configuration section element_name." 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, özel yapılandırma bölümü ve o bölümün ayarlarının nasıl tanımlanacağını gösterilmektedir.

<configuration>

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

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

</configuration>

Öğe Bilgileri

Yapılandırma bölümü işleyicisi	Uygulanmaz.
Yapılandırma üyesi	ConfigurationSectionCollection ConfigurationSectionGroupCollection
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 1.0, 1.1 veya 2.0 Microsoft Visual Studio 2003 veya Visual Studio 2005

Ayrıca bkz.

Aracılığıyla paylaş