Aracılığıyla paylaş

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

  • Makale

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.

<clear />

Öznitelikler ve Öğeler

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

Öznitelikler

Yok.

Alt Öğeler

Yok.

Üst Öğeler

Öge

Açyklama

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

clear ögesi, 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.

Bir yapılandırma dosyası, işleyici başvurusu kaldırıldıktan sonra yapılandırma bölümünü kullanmaya çalışırsa, ASP.NET "Tanımlanamayan yapılandırma bölümü element_name." sunucu hatasını verir.

Örnek

Aşağıdaki kod örneğinde, Machine.config dosyasında daha önce tanımlanmış olan bir bölümü temizlemek için uygulama yapılandırma dosyasındaki clear ögesinin nasıl kullanıldığı gösterilmiştir.

Machine.config dosyasındaki aşağıdaki kod, uygulama yapılandırma dosyasından önce okunan iki bölümü, sampleSection ve anotherSampleSection, bildirir.

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

Uygulama yapılandırma dosyasından alınan aşağıdaki kod, daha önce bildirilen tüm bölümleri temizler. Uygulama, Machine.config dosyasında bildirilen bölümlerin hiçbirini kullanamaz ve alamaz. Ancak uygulama, anotherSection'daki ayarları kullanabilir, çünkü anotherSection, clear ögesinden sonra gelir.

<configuration>

<configSections>

<clear/>

<section name="anotherSection"

type="System.Configuration.NameValueSectionHandler" />

</configSections>

</configuration>

Öğe Bilgileri

Yapılandırma bölümü işleyicisi

Uygulanmaz.

Yapılandırma üyesi

Clear()

Clear()

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.

Başvuru

configSections Ögesi (Genel Ayarlar Şeması)

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

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

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

configuration Ögesi (Genel Ayarlar Şeması)

Kavramlar

ASP.NET Yapılandırması dosyası hiyerarşi ve Kalıtım

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

ASP.NET Yapılandırması senaryoları

Diğer Kaynaklar

Genel Yapılandırma Ayarları (ASP.NET)

ASP.NET Yapılandırma Ayarları

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

ASP.NET Web site Administation

ASP.NET Yapılandırması API