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

Makale
08/01/2011

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

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

Öznitelikler ve Öğeler

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

Öznitelikler

Öznitelik	Açıklama
allowDefinition	İsteğe bağlı Enum özniteliği. Sadece ASP.NET uygulamaları için geçerlidir. Bölümün hangi yapılandırma dosyasında kullanılabildiğini belirtir. Bu öznitelik aşağıdaki azalan kapsam sırasındaki (ConfigurationAllowDefinition sabit listesinde tanımlanan) değerlerden biri olabilir. ValueAçıklama Everywhere Bölümün herhangi bir yapılandırma dosyasında veya dizininde yapılandırılmasına aşağıdaki gibi izin verir. Machine.config. Kök Web.config. Bir uygulama için Web.config. Sanal dizin. Uygulamada fiziksel alt dizin. Eğer hiçbir allowDefinition özniteliği kullanılmamışsa Everywhere varsayılır.Varsayılan değer budur. MachineToApplication Bölümün aşağıdaki dosyalardan birinde yapılandırılmasını sağlar: Machine.config. Kök Web.config. Bir uygulama için Web.config. Bu, uygulamada sanal dizinlerdeki veya fiziksel alt dizinlerdeki Web.config dosyalarını hariç tutar. MachineToWebRoot Bölümün aşağıdaki dosyalardan birinde yapılandırılmasını sağlar: Machine.config. Kök Web.config. Machine.config ve kök Web.config dosyalarının ikisi de %SystemRoot%\Microsoft.NET\Framework\versionNumber\CONFIG konumunda bulunur. MachineOnly Bölümün sadece %SystemRoot%\Microsoft.NET\Framework\versionNumber\CONFIG konumunda bulunan Machine.config dosyasında yapılanmasına izin verir.
allowExeDefinition	İsteğe Bağlı Enum özniteliği. Yalnızca .NET Framework istemci uygulamaları için geçerlidir. Bölümün hangi yapılandırma dosyasında kullanılabildiğini belirtir. Bu öznitelik aşağıdaki azalan kapsam sırasındaki (ConfigurationAllowExeDefinition sabit listesinde tanımlanan) değerlerden biri olabilir. ValueAçıklama MachineToApplication Bölümün aşağıdaki dosyalardan birinde yapılandırılmasını sağlar: Machine.config. Uygulama yapılandırması. MachineToRoamingUser MachineToLocalUser MachineOnly Bölümün sadece %SystemRoot%\Microsoft.NET\Framework\versionNumber\CONFIG konumunda bulunan Machine.config dosyasında yapılanmasına izin verir.
allowLocation	İsteğe bağlı Boolean özniteliği. Sadece ASP.NET uygulamaları için geçerlidir. Bölümün location ögesi içinde kullanılıp kullanılmayacağını belirler. Varsayılan, True değeridir.
name	Gerekli String özniteliği. type özniteliğinde 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 ögenin adıdır.
restartOnExternalChanges	İsteğe bağlı Boolean özniteliği. ASP.NET uygularında geçerli değildir. Bölümün yapılandırma verileri değişmişse uygulamanın yeniden başlatılmasının gerekip gerekmediğini belirler.
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 örnek sözdiziminde 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 konumunda bulunması gerekir.

Alt Öğeler

Yok.

Üst Öğeler

Öğe	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

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 düzen ve adlandırma çakışmalarından kaçınma açısından sectionGroup ögelerinde mantıksal olarak gruplandırılabilir. section ve sectionGroup ögeleri configSections ögesinde yer alır.

Varsayılan Yapılandırma

.NET Framework 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	ConfigurationSection
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) 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ş