pages için controls Ögesi (ASP.NET Ayarlar Şeması)

Etiket öneklerinin bulunduğu kayıt yönergeleri ve ad uzayları koleksiyonunu tanımlar.

Bu öge .NET Framework sürüm 2.0'da yenidir.

<controls> 
   <add /> 
</controls>

Öznitelikler ve Öğeler

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

Öznitelikler

Yok.

Alt Öğeler

Öge

Açıklama

add

İsteğe bağlı öğe.

Ön derleme sırasında kullanılan etiket önekleri koleksiyonuna etiket öneki ekler.

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

system.web

Yapılandırma dosyasında ASP.NET yapılandırma ayarları için kök öge belirtir ve ASP.NET Web uygulamalarını yapılandıran ve uygulamaların davranışını denetleyen yapılandırma ögelerini içerir.

pages

Genel olarak, yapılandırma dosyasının kapsamı içinde kullanılan sayfalar ve denetimlerin ASP.NET yönergeleri gibi sayfaya özel yapılandırma ayarlarını tanımlar.

Açıklamalar

controls ögesi, etiket öneklerinin bulunduğu kayıt yönergeleri ve isim uzayları koleksiyonunu tanımlar. Bu öge bir ASP.NET sayfasında @ Register yönergesine karşılık gelir. @ Register yönergesi kullanıcı denetimi için etiket öneki belirtmenize olanak verir.

Etiket önekleri, COM ve kullanıcı denetimlerinin düzgün çalışması için dahil edilmesi gereken derleme ve isim uzaylarına ASP.NET'te isim uzayı ilişkilendirir. controls ögesi yapılandırılırken aşağıdaki bilgiler yarar sağlar:

  • Bir kullanıcı denetimine uygulandıysa, add alt ögesinin tagPrefix, tagName ve source özniteliklerini tanımlamalısınız.

  • Bir özel denetime uygulandıysa, add alt ögesinin tagPrefix, namespace ve assembly özniteliklerini tanımlamalısınız. Denetim uygulama kodu dizininde ise, assembly özniteliği gerekli değildir.

Aynı tagPrefix değerini birden çok derleme veya ad alanına eşlemek için kullanabilirsiniz.

Varsayılan Yapılandırma

Aşağıdaki varsayılan controls ögesi kök Web.config dosyasında yapılandırılır.

<pages>
   <controls>
      <add 
         tagPrefix="asp" 
         namespace="System.Web.UI.WebControls.WebParts" 
         assembly="System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" 
      />
   </controls>
   <!-- Other elements -->
</pages>

Örnek

Aşağıdaki kod örneğinde, TagPrefixInfo sınıfının üyeleri olarak da program aracılığıyla erişilebilen controls ögesinin birkaç özniteliği için bildirimli olarak nasıl değer belirtileceği gösterilmektedir.

   <pages>
      <controls>
         <!—- Searches all linked assemblies for the namespace -->
         <add 
            tagPrefix="MyTags1" 
            namespace="MyNameSpace"/>
         <!-- Uses a specified assembly -->
         <add 
            tagPrefix="MyTags2"
            namespace="MyNameSpace" 
            assembly="MyAssembly"/>
         <!-- Uses the specified source for the user control -->
         <add 
            tagPrefix="MyTags3" 
            tagName="MyCtrl" 
            source="MyControl.ascx"/>
      </controls>
   </pages>

Öğe Bilgileri

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

PagesSection

Yapılandırma üyesi

Controls

TagPrefixCollection

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 2.0

Microsoft Visual Studio 2003 veya Visual Studio 2005

Ayrıca bkz.

Görevler

Nasıl Yapılır: Özel dizin Yer Ayarlar kullanarak yapılandırma

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

Başvuru

pages Ögesi (ASP.NET Ayarlar Şeması)

pages'te controls için add Ögesi (ASP.NET Ayarlar Şeması)

pages için tagMapping Ögesi (ASP.NET Ayarlar Şeması)

pages için namespaces Ögesi (ASP.NET Ayarlar Şeması)

system.web Ögesi (ASP.NET Ayarlar Şeması)

configuration Ögesi (Genel Ayarlar Şeması)

@ Page

@ Register

System.Configuration

System.Web.Configuration

Controls

TagPrefixCollection

PagesSection

Kavramlar

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

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

Diğer Kaynaklar

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

ASP.NET Yapılandırma Ayarları

ASP.NET Web site Administation

ASP.NET Yapılandırması API