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

Makale
08/01/2011

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.

<pages     
   asyncTimeout="number"
   autoEventWireup="[True|False]"
   buffer="[True|False]"
   clientIDMode="[AutoID|Predictable|Static]"
   compilationMode="[Always|Auto|Never]" 
   controlRenderingCompatibilityVersion="[3.5|4.0]"
   enableEventValidation="[True|False]"
   enableSessionState="[True|False|ReadOnly]"
   enableViewState="[True|False]"
   enableViewStateMac="[True|False]"
   maintainScrollPositionOnPostBack="[True|False]" 
   masterPageFile="file path" 
   maxPageStateFieldLength="number" 
   pageBaseType="typename, assembly"
   pageParserFilterType="string" 
   smartNavigation="[True|False]"
   styleSheetTheme="string"
   theme="string"
   userControlBaseType="typename"
   validateRequest="[True|False]"
   viewStateEncryptionMode="[Always|Auto|Never]" 
>
   <controls>...</controls>
   <namespaces>...</namespaces>
   <tagMapping>...</tagMapping>
   <ignoreDeviceFilters>...</ignoreDeviceFilters>
</pages>

Öznitelikler ve Öğeler

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

Öznitelikler

Öznitelik	Açıklama
asyncTimeout	İsteğe bağlı TimeSpan özniteliği. Zaman uyumsuz işleme sırasında tamamlamak amacıyla zaman uyumsuz bir işleyici için beklenecek süreyi saniye cinsinden belirtir. Bu öznitelik .NET Framework sürüm 2.0'da yenidir. Varsayılan değer "0:00:45" (45 saniye)'tir.
autoEventWireup	İsteğe bağlı Boolean özniteliği. Sayfa olaylarının otomatik olarak etkinleştirilip etkinleştirilmeyeceğini belirtir. Bu, otomatik olay bağlama gerçekleştiğinde oluşur ve sistemin otomatik olarak belirli imza yöntemlerini iliştirdiği anlamına gelir (örneğin Page_Load). Daha fazla bilgi için bkz. ASP.NET Web Sunucu Denetimi olay modeli. Varsayılan, True değeridir.
buffer	İsteğe bağlı Boolean özniteliği. URL kaynağının yanıt arabelleği özelliğini kullanıp kullanmayacağını belirtir. Varsayılan, True değeridir.
clientIDMode	Denetim için ClientID değerleri üretmek amacıyla kullanılacak olan algoritmayı belirtir. Predictable varsayılan değerdir. Inherit denetimler için varsayılan değerdir. Bu nedenle, bir sayfadaki denetimler için varsayılan algoritma, sayfanın ClientIDMode ayarı tarafından belirlenir. Farklı bir varsayılan değeri, sayfanın @ Page yönergesinde veya kullanıcı denetiminin @ Control yönergesinde ayarlayabilirsiniz. Algoritmalar hakkında daha fazla bilgi için bkz. ClientIDMode ve ASP.NET Web Sunucu Denetimi kimliği.
compilationMode	İsteğe bağlı CompilationMode özniteliği. Bir ASP.NET sayfasının veya denetiminin çalışma zamanında derlenip derlenmemesi gerektiğini belirtir. compilationMode özniteliği, .NET Framework sürüm 2.0'da yenidir. Bu öznitelik aşağıdaki olası değerlerden biri olabilir. Varsayılan, Always değeridir. ValueAçyklama Always Sayfa her zaman derlenmelidir. Auto Mümkünse, ASP.NET sayfayı derlemez. Never Sayfa veya denetim hiçbir zaman dinamik olarak derlenmemelidir. Bir sayfa derleme gerektiren bir komut dosyası bloğu veya kod yapısı içeriyorsa, ASP.NET bir hata döndürür ve sayfa çalışmaz.
controlRenderingCompatibilityVersion	Denetimlerin HTML'i ASP.NET'in önceki bir sürümünde yapıldığı gibi veya güncel sürümünde tasarlandığı gibi işleyip işlememesi gerektiğini belirtir. Not controlRenderingCompatibilityVersion , ASP.NET 4'te yenidir.Bunu güncel sürüm numarasını ayarlamak, ayarlamamakla aynı etkiye sahiptir.Her iki durumda da denetimler, güncel sürüm için tasarlanmış gibi HTML işler.Bu özniteliğin ayarlanabildiği en önceki sürüm 3.5'tir. Daha fazla bilgi için bkz. PagesSection.ControlRenderingCompatibilityVersion ve Control.RenderingCompatibility özelliği.
enableEventValidation	Sayfalar ve denetimlerin geri gönderme ve geri arama olaylarını doğrulayıp doğrulamadığını belirtir. Varsayılan, True değeridir.
enableSessionState	İsteğe bağlı String özniteliği. Yapılandırma dosyasının kapsamı içinde olan kaynaklar için oturum durumu gereksinimleri belirtir. enableSessionState özniteliği aşağıdaki değerlerden herhangi biri olabilir. Varsayılan, True değeridir. ValueAçyklama False Oturum durumunun devre dışı olduğunu gösterir. ReadOnly Oturum durumunun yazılabilir olduğunu gösterir. True Oturum durumunun etkin olduğunu gösterir.
enableViewState	İsteğe bağlı Boolean özniteliği. Görünüm durumunun etkinleştirilmiş ve sayfa isteklerinde saklanmış olup olmadığını belirtir. Varsayılan, True değeridir.
enableViewStateMac	İsteğe bağlı Boolean özniteliği. ASP.NET'in, istemciden geri gönderilen sayfalar için görünüm durumu üzerinde bir ileti kimlik doğrulama kodu (MAC) çalıştırıp çalıştırmayacağını belirtir. True ise, şifrelenmiş görünüm durumunun istemci tarafından değiştirilmediğini kanıtlamak amacıyla denetlenir. Varsayılan, True değeridir.
maintainScrollPositionOnPostBack	İsteğe bağlı Boolean özniteliği. Sayfalar sunucuya geri gönderildiğinde, kullanıcıyı istemci tarayıcısında aynı konuma döndürüp döndürmeyeceğini belirtir. False ise, kullanıcı geri göndermede sayfanın üst kısmına döndürülür. Bu öznitelik, .NET Framework sürüm 2.0'da yenidir. Varsayılan, False değeridir.
masterPageFile	İsteğe bağlı String özniteliği. Yerel yapılandırma dosyasıyla ilişkili ana sayfa yolunu belirtir. True olarak ayarlanmış masterPageFile özniteliğine sahip sayfalar, üst düzey denetimi olarak Content denetimi içermelidir. Bu öznitelik, .NET Framework sürüm 2.0'da yenidir. Varsayılan değer, boş dizedir ("").
maxPageStateFieldLength	İsteğe bağlı Int32 özniteliği. Sayfanın durum alanı için kullanılan en büyük uzunluğu karakter cinsinden belirtir. Pozitif bir sayıya ayarlanmış ise, istemci tarayıcısına gönderilen görünüm durumu alanı parçalara ayrılır ve her parça maxPageStateFieldLength özniteliğinde belirtilen boyuttan daha az olur. Negatif bir sayıya ayarlanmışsa, görünüm durumu alanı parçalara ayrılmamalıdır. Bu öznitelik, .NET Framework sürüm 2.0'da yenidir. Varsayılan, "-1" değeridir.
pageBaseType	İsteğe bağlı String özniteliği. Sayfalar tek başına olduğu zaman kullanılacak olan temeli belirtir. Bu, tek başına olan dosyada inherits özniteliği tarafından geçersiz kılınır. Varsayılan "System.Web.UI.Page"dir.
pageParserFilterType	İsteğe bağlı String özniteliği. Bir ögeye, ayrıştırma zamanında sayfada izin verilip verilmediğini belirlemek için ASP.NET ayrıştırıcısı tarafından kullanılan filtrenin tür adını belirtir. Filtre, PageParserFilter sınıfından türetilmelidir. Bu öznitelik, .NET Framework sürüm 2.0'da yenidir. Varsayılan değer, boş dizedir ("").
smartNavigation	İsteğe bağlı Boolean özniteliği. Akıllı gezinme özelliğinin etkin olup olmadığını belirtir. Akıllı gezinme özelliğinin kullanılabilmesi için Microsoft Internet Explorer sürüm 5.5 veya daha sonraki bir sürümü gerekir. Akıllı gezinme etkinleştirildiğinde, kullanıcı aşağıdaki yararları görür: Gezinme yanıp sönmesi ortadan kaldırılmıştır. Sayfalar arasındaki kaydırma konumu kalıcıdır. Öge odağı sayfalar arasında kalıcıdır. Sayfanın son durumu, tarayıcıdaki geçmiş tarafından saklanan tek durumdur. Bu öznitelik, .NET Framework 2.0'da yenidir ancak, maintainScrollPositionOnPostBack özniteliği için kullanım dışı bırakılmıştır. Varsayılan, False değeridir.
styleSheetTheme	İsteğe bağlı String özniteliği. Denetim bildirimlerinden sonra uygulanacak temayı tanımlayan tema özniteliğinden farklı olarak denetim bildirimlerinden önce temayı uygulamak amacıyla kullanılan "adlandırılmış tema" klasörünün adını belirtir. Bu öznitelik, .NET Framework sürüm 2.0'da yenidir. Varsayılan değer, boş dizedir ("").
theme	İsteğe bağlı String özniteliği. Yapılandırma dosyasının kapsamı içinde olan sayfalar için kullanılan tema adını belirtir. Belirtilen temanın uygulama veya genel tema olarak bulunması gerekir. Tema yoksa, bir HttpException özel durumu oluşturulur. Bu öznitelik, .NET Framework sürüm 2.0'da yenidir. Varsayılan değer, boş dizedir ("").
userControlBaseType	İsteğe bağlı String özniteliği. Sayfalar tek başına olduğu zaman kullanılacak olan temeli belirtir. "System.Web.UI.UserControl" varsayılandır.
validateRequest	İsteğe bağlı Boolean özniteliği. ASP.NET'in tarayıcıdan yapılan tüm girdileri tehlikeli veri olasılığına karşı inceleyeceğini gösterir. True ise, istek doğrulama, bütün girdi verileri tehlike riski taşıyan değerler içeren bir listeyle karşılaştırılarak gerçekleştirilir. Bir eşleşme olursa, ASP.NET HttpRequestValidationException özel durumu oluşturur. Varsayılan, True değeridir.
viewStateEncryptionMode	İsteğe bağlı ViewStateEncryptionMode özniteliği. Görünüm durumu şifreleme modunu belirtir. ViewStateEncryptionMode özelliği yapılandırma dosyasında ayarlanan bu özniteliği geçersiz kılar. Bu öznitelik aşağıdaki olası değerlerden biri olabilir. ValueAçyklama Always Görünüm durumu her zaman şifrelenir. Auto Görünüm durumu, bir denetim istediği zaman şifrelenir. Never Bir denetim istese bile, görünüm durumu hiçbir zaman şifrelenmez. Bu öznitelik, .NET Framework sürüm 2.0'da yenidir. Varsayılan, Auto değeridir.

Alt Öğeler

Öge	Açıklama
controls	Etiket öneklerinin bulunduğu kayıt yönergeleri ve ad uzayları koleksiyonunu tanımlar.
namespaces	Bütünleştirilmiş kod ön derlemesi sırasında kullanmak için içe aktarma yönergeleri koleksiyonu tanımlar.
tagMapping	Derleme sırasında diğer etiket türleri ile yeniden eşlenen etiket türleri koleksiyonunu belirtir.
ignoreDeviceFilters	Tarayıcının sayfanın işlenmiş olduğunu yoksayması gereken aygıt ögeleri koleksiyonunu tanımlar. Daha fazla bilgi için bkz. IgnoreDeviceFilters.

Üst Öğeler

Öge	Açıklama
configuration	Ortak dil çalıştırma modülü ile .NET Framework temelli 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.

Açıklamalar

pages ögesi sayfaya özel yapılandırma ayarlarını tanımlar. Bu yapılandırma bölümü, yapılandırma dosyasının kapsamı içindeki tüm sayfalar ve denetimler için genel olarak belirli ASP.NET sayfa ve denetim yönergeleri ayarını destekler. Bu, derleyiciler ASP.NET Web Forms sayfası (.aspx) ve kullanıcı denetimi (.ascx) dosyalarını işlerken sayfa ve kullanıcı denetimi derleyicileri tarafından kullanılan ayarları belirten aşağıdaki sayfa düzeyi yönergelerini içerir:

@ Page yönergesi (@ Page).
namespaces alt ögesi aracılığıyla @ Import yönergesi (@ Import).
controls alt ögesi aracılığıyla @ Register yönergesi (@ Register).

pages ögesi, tagMapping ögesi aracılığıyla çalışma zamanında etiketi türlerini diğer etiket türleriyle eşlemek için de destek sağlar.

Not
@ Page yönergesini bir ana sayfaya eklemek, ana sayfaya bağlı olan sayfalarda aynı yönerge bildiriminin kullanımına izin vermez.Bunun yerine, sayfa yönergelerini genel olarak tanımlamak için pages yapılandırma ögesini kullanın.

Varsayılan Yapılandırma

Aşağıdaki varsayılan pages ögesi Machine.config dosyası veya kök Web.config dosyasında tam olarak yapılandırılmamıştır. Ancak bu, uygulamanın varsayılan yapılandırmasıdır. Ad uzayları ve denetimler, kök Web.config dosyasına eklenir.

<pages 
   buffer="true" 
   clientIDMode="AutoID" 
   enableSessionState="true" 
   enableViewState="true" 
   enableViewStateMac="true" 
   smartNavigation="false" 
   autoEventWireup="true" 
   pageBaseType="System.Web.UI.Page" 
   userControlBaseType="System.Web.UI.UserControl" 
   validateRequest="true" 
   masterPageFile="" 
   theme="" 
   styleSheetTheme="" 
   maxPageStateFieldLength="-1" 
   compilationMode="Always" 
   pageParserFilterType="" 
   viewStateEncryptionMode="Auto" 
   maintainScrollPositionOnPostBack="false" 
   asyncTimeout="45"
>
   <namespaces>
      <clear />
   </namespaces>
   <tagMapping>
      <clear />
   </tagMapping>
</pages>

Örnek

Aşağıdaki kod örneğinde, birkaç sayfa yapılandırma ayarının nasıl belirtileceği gösterilmiştir.

<configuration>
   <system.web>
      <pages buffer="true"
         enableSessionState="true"
         autoEventWireup="true"
         maintainScrollPositionOnPostBack="true"
         masterPageFile = "~/Masters/Page1.master" />
  </system.web>
</configuration>

Öğe Bilgileri

Yapılandırma bölümü işleyicisi	PagesSection
Yapılandırma üyesi	Pages Page
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) 5.0 veya sonraki sürümleri .NET Framework 1.0 veya daha sonraki sürümleri Microsoft Visual Studio 2003 veya sonraki sürümleri

Ayrıca bkz.

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

Öznitelikler ve Öğeler

Öznitelikler

Alt Öğeler

Üst Öğeler

Açıklamalar

Varsayılan Yapılandırma

Örnek

Öğe Bilgileri

Ayrıca bkz.

Görevler

Başvuru

Kavramlar

Diğer Kaynaklar

Ek kaynaklar