Aracılığıyla paylaş

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

  • Makale

Devralınan bölüm ve bölüm grubuna yapılan başvuruyu kaldırır.

<remove 
   name="section name" 
/>

Öznitelikler ve Öğeler

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

Öznitelikler

Öznitelik

Açıklama

name

Gerekli String özniteliği.

Kaldırılacak bölüm veya bölüm grubunun adını belirtir. Bu, section'ın name özniteliği veya başvuruyu ekleyen sectionGroup ögesiyle aynıdır.

Alt Öğeler

Yok.

Ü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.

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

remove ögesi devralınan bölümlere veya bölüm gruplarına yapılan başvuruyu kaldırır. Yeni bölümler ve bölüm grupları, section ve sectionGroup ögeleri kullanılarak mevcut yapılandırma dosyasındaki koleksiyona eklenebilir.

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ü öğe_adı." sunucu hatasını verir.

Örnek

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

Aşağıdaki Machine.config dosyası kodu sampleSection adlı bölümü bildirir.

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

Aşağıdaki örnek uygulama yapılandırma dosyası sampleSection bölümünü kaldırır. Kaldırdıktan sonra uygulama, sampleSection içindeki ayarları alamaz. 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ü öğe_adı." sunucu hatasını verir.

<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

Remove(String)

Remove(String)

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 clear Ö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