Bölüm Ögeleri Tarafından Devralınan Genel Öznitelikler

ASP.NET, yapılandırma ayarlarını kaynaklara uygularken hiyerarşik bir düzen izler. Yapılandırma ayarları üst yapılandırma dosyalarından devralınır. Bu konu, tüm bölüm ögeleri tarafından devralınan birkaç genel özniteliği listeler.

Section Ögesi

Bölüm ögeleri yapılandırma bölümü üyeleridir. Bu, yapılandırma bölümü grupları üyesi olan ögeleri içermez.

Yapılandırma bölümü bildirimleri configSections ögesinin içindeki yapılandırma dosyasının üst kısmında görünür. section ögesi içinde yer alan her bildirim, bölümün adını ve o bölümdeki yapılandırma verilerini işleyen .NET Framework sınıfının (ConfigurationSection'dan türetilmiş) adını belirtir. section etiketleri sectionGroup etiketleri içinde gruplandırılabilir.

Daha fazla bilgi için, bkz. ASP.NET Yapılandırması dosyalarının veya ASP.NET Yapılandırması dosyalarını Düzenlemek.

Genel Öznitelikler

Aşağıdaki tablo, herhangi bir bölüm ögesi için ayarlanabilen genel öznitelikleri açıklar. Bu genel öznitelikler de bölüm ögelerinin alt ögeleri tarafından devralınır. Adlarında lock işini içeren tüm öznitelikler, belirtilen yapılandırma dosyasının içeriğini değişikliklerden korumak için tasarlanmıştır. Hiçbir öge veya öznitelik varsayılan olarak kilitli değildir.

Öznitelik	Açıklama
configSource	İsteğe bağlı String özniteliği. İlişkili yapılandırma bölümünde tanımlanan içerme dosyasının (eğer varsa) adını belirtir. Program aracılığıyla ConfigSource özelliği ile erişilebilir. configSource özniteliğini kullandığınızda öge ayarlarını birleştirme olanağınız olmadığı için tüm bölümü ayrı bir dosyaya taşımanız gerekir. Dış dosyadaki herhangi bir değişiklik, varsayılan olarak uygulamanın yeniden başlatılmasına neden olur. Uygulamanın her değişiklikten sonra yeniden başlamayacak şekilde davranışını değiştirmek için Web.config dosyasında configSections için section Ögesi (Genel Ayarlar Şeması)'yı yapılandırabilir ve restartOnExternalChanges özniteliğini false olarak ayarlayabilirsiniz.
lockAllAttributesExcept	İsteğe bağlı String özniteliği; değer virgülle ayrılmış bir liste olabilir. Belirtilenler dışındaki tüm üst öge özniteliklerini kilitler. Program aracılığıyla LockAllAttributesExcept özelliği ile erişilebilir. Yapılandırma hiyerarşisinin alt düzeyleri, hiyerarşi içinde kendilerinden yukarıda olan düzeyleri hiçbir zaman kilitleyemez.
lockAllElementsExcept	İsteğe bağlı String özniteliği; değer virgülle ayrılmış bir liste olabilir. Üst ögenin belirtilenler dışındaki tüm alt ögelerini kilitler. Program aracılığıyla LockAllElementsExcept özelliği ile erişilebilir.
lockAttributes	İsteğe bağlı String özniteliği; değer virgülle ayrılmış bir liste olabilir. Üst ögenin tüm özniteliklerini kilitler. Program aracılığıyla LockAttributes özelliği ile erişilebilir.
lockElements	İsteğe bağlı String özniteliği; değer virgülle ayrılmış bir liste olabilir. Üst ögenin tüm alt ögelerini kilitler. Program aracılığıyla LockElements özelliği ile erişilebilir.
lockItem	İsteğe bağlı String özniteliği. Özniteliğin oluştuğu ögenin kilitli olması gerekiyorsa true; aksi durumda false olur. Varsayılan, false değeridir. Herhangi bir ögeyi kilitlemek için kullanılmasının yanı sıra bu öznitelik, özellikle belirtilen bir koleksiyonda koleksiyon ögelerini kilitlemek için de kullanılabilir. Ayrıca, öznitelik tüm bölümü kilitlemek için kullanılabilir. Program aracılığıyla LockItem özelliği ile erişilebilir.

Örnek

Aşağıdaki kod örneği, Machine.config dosyasının bir bölümüdür. Yapılandırma bölümü işleyicileri system.web bölümü grubu ve anonymousIdentification bölümü için bildirilir. Bunun altında, sistem.Web ve anonymousIdentification yapılandırma ögeleri bildirilir.

sistem.Web yapılandırma ögesi yapılandırma bölümü grubu üyesidir, öznitelik içermez.

anonymousIdentification yapılandırma ögesi yapılandırma bölümü üyesidir; bu nedenle, yukarıdaki tabloda listelenen öznitelikleri devralır. Kendi configSource özniteliğinin (ögenin içeriğini içerecek şekilde) atanan harici bir dosyası vardır ve içeriğin değişmesini engellemek için lockItem özniteliği true olarak ayarlanır.

<configuration>

  <configSections>
    <!-- Other configuration sections. -->
    <sectionGroup name="system.web" ...>
      <section name="anonymousIdentification" ... />
    </sectionGroup>
  </configSections>

  <system.web>
    <anonymousIdentification  configSource="IDSourceFile.xml" 
       lockItem="true" />
  </system.web>

</configuration>

Ayrıca bkz.

Görevler

Nasıl Yapılır: ASP.NET Yapılandırması kilitlemek Ayarlar

Kavramlar

ASP.NET yapılandırmasına genel bakış

ASP.NET Yapılandırması senaryoları

ASP.NET Yapılandırması güvenliğini sağlama

ASP.NET Yapılandırması dosyalarını Düzenlemek

Diğer Kaynaklar

ASP.NET Yapılandırması dosyalarının