<section> öğesi

Yapılandırma bölümü bildirimi içerir.

<configuration>
  <configSections>
    <section>

<configuration>
  <configSections>
    <sectionGroup>
      <section>

Sözdizimi

<section name="section name"
         type="configuration section handler class, assembly"
         allowDefinition="Everywhere|MachineOnly|MachineToApplication"
         allowLocation="true|false" />

Gerekli öznitelikler

Özellik	Description
name	Yapılandırma bölümünün adını belirtir.
type	Yapılandırma dosyasından bölümü okuyan yapılandırma bölümü işleyici sınıfının adını belirtir. Tür değeri "tam-nitelenmiş-bölüm-işleyici-sınıf-adı, basit-bütünleştirilmiş kod-adı" söz dizimine sahiptir. Basit derleme adı, .dll dosya uzantısı olmayan kök dosya adıdır.

İsteğe bağlı öznitelikler

Aşağıdaki öznitelikler yalnızca ASP.NET uygulamalar için geçerlidir. Yapılandırma sistemi, diğer uygulama türleri için bu öznitelikleri yoksayar.

İsteğe bağlı öznitelik	Description
allowDefinition	Bölümün hangi yapılandırma dosyasında kullanılabileceğini belirtir. Aşağıdaki değerlerden birini kullanın: Her yerde Bölümün herhangi bir yapılandırma dosyasında kullanılmasına izin verir. Bu varsayılan seçenektir. MachineOnly Bölümün yalnızca makine yapılandırma dosyasında (Machine.config) kullanılmasına izin verir. MachineToApplication Bölümün makine yapılandırma dosyasında veya uygulama yapılandırma dosyasında kullanılmasına izin verir.
allowLocation	bölümün öğesi içinde <location> kullanılıp kullanılamayacağını belirler. Aşağıdaki değerlerden birini kullanın: doğru öğesinin içinde bölümün kullanılmasına <location> izin verir. Bu varsayılan seçenektir. false bölümün öğesi içinde kullanılmasına <location> izin vermez.

Üst öğeler

Üst öğe	Description
<configSections>	Yapılandırma bölümünü ve ad alanı bildirimlerini içerir.
<sectionGroup>	Yapılandırma bölümleri için bir ad alanı tanımlar.

Uyarı

Öğe <section> , her ikisinin alt <configSections><sectionGroup> öğesidir ancak her ikisi için de değildir.

Alt öğeler

Hiç kimse

Açıklamalar

Yapılandırma bölümü bildirilmesi temelde yapılandırma dosyası için yeni bir öğe tanımlar. Yeni öğe, yapılandırma bölümü işleyicisinin (arabirimi uygulayan IConfigurationSectionHandler bir sınıf) okuduğu ayarları içerir. Tanımladığınız bir bölümün öznitelikleri ve alt öğeleri, ayarlarınızı okumak için kullandığınız bölüm işleyicisine bağlıdır.

Machine.config dosyasında bir yapılandırma bölümü işleyicisi bildirmek, özniteliği aksini belirtmediği sürece yapılandırma bölümünü o bilgisayardaki herhangi bir uygulama yapılandırma dosyasında kullanmanıza allowDefinition olanak tanır.

Example

Aşağıdaki örnekte bir yapılandırma bölümünün nasıl tanımlanacağı ve bu bölümün ayarlarının nasıl tanımlanacağı gösterilmektedir:

<configuration>
  <configSections>
    <section name="sampleSection"
             type="System.Configuration.SingleTagSectionHandler"
             allowLocation="false" />
  </configSections>
  <sampleSection setting1="Value1"
                 setting2="value two"
                 setting3="third value" />
</configuration>

Yapılandırma dosyası

Bu öğe uygulama yapılandırma dosyasında, makine yapılandırma dosyasında (Machine.config) ve uygulama dizini düzeyinde olmayan Web.config dosyalarında kullanılabilir.

Ayrıca bakınız

• .NET Framework için yapılandırma dosyası şeması