Element pages (schéma nastavení ASP.NET)

Článek
08/11/2011

Globálně definuje nastavení konfigurace specifické pro stránku, jakými jsou například globální směrnice technologie ASP.NET pro stránky a ovládací prvky, které jsou v oblasti působnosti konfiguračního souboru.

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

Atributy a prvky

Následující části popisují atributy, podřízené prvky a rodičovské prvky.

v případě vícehodnotových atributů

Atribut	Popis
asyncTimeout	Volitelný TimeSpan atributu. Určuje počet sekund čekání na dokončení asynchronní obslužné rutiny během asynchronního zpracování. Tento atribut je v rozhraní .NET Framework verze 2.0 nový. Výchozí hodnota je "0:00:45" (45 sekund).
autoEventWireup	Nepovinný atribut Boolean. Určuje, zda jsou události stránky automaticky povoleny. To znamená, pokud nastane automatické propojení událostí, což znamená, že systém automaticky připojí metody určité signatury (například Page_Load). Další informace naleznete v tématu Model událostí ovládacích prvků webového serveru technologie ASP.NET. Výchozí hodnota je True.
buffer	Nepovinný atribut Boolean. Určuje, zda prostředek URL používá ukládání odpovědi do vyrovnávací paměti. Výchozí hodnota je True.
clientIDMode	Určuje algoritmus použitý ke generování hodnot ClientID pro ovládací prvky. Výchozí hodnota je Predictable. Výchozí hodnota ovládacích prvků je Inherit. Proto je výchozí algoritmus ovládacích prvků na stránce určen nastavením ClientIDMode dané stránky. V direktivě stránky @ Page lze nastavit různé výchozí hodnoty. Případně v direktivě @ Control u uživatelských ovládacích prvků. Další informace o těchto algoritmech naleznete v tématech ClientIDMode a Identifikace ovládacích prvků technologie ASP.NET.
compilationMode	Nepovinný atribut CompilationMode. Určuje, zda by stránka nebo ovládací prvek technologie ASP.NET měl být kompilován v době běhu. Atribut compilationMode je v rozhraní .NET Framework verze 2.0 nový. Tento atribut může nabývat jedné z následujících možných hodnot. Výchozí hodnota je Always. HodnotaPopis Always Stránka by měla být vždy kompilována. Auto Pokud je to možné, technologie ASP.NET stránku nezkompiluje. Never Stránka nebo ovládací prvek by neměl být nikdy dynamicky kompilován. Pokud stránka obsahuje blok skriptu nebo konstrukci kódu vyžadující kompilaci, vrátí technologie ASP.NET chybu a stránka nebude pracovat.
controlRenderingCompatibilityVersion	Určuje, zda by ovládací prvky měly vykreslovat jazyk HTML dřívější verzí technologie ASP.NET, nebo způsobem, jakým je to navrženo v aktuální verzi. Poznámka controlRenderingCompatibilityVersion je novinkou technologii ASP.NET verze 4.Jeho nastavení na číslo aktuální verze má stejný efekt, jako jeho nenastavení.V obou případech vykreslují ovládací prvky jazyk HTML jak je navrženo v aktuální verzi.Nejstarší verze, na kterou lze tento atribut nastavit, je 3.5. Další informace naleznete ve vlastnostech PagesSection.ControlRenderingCompatibilityVersion a Control.RenderingCompatibility.
enableEventValidation	Určuje, zda stránky a ovládací prvky ověřují zpětné volání a události zpětných volání. Výchozí hodnota je True.
enableSessionState	Nepovinný atribut String. Určuje požadavky stavu relace pro prostředky, které spadají do oblasti působnosti konfiguračního souboru. enableSessionState Atribut může být jeden z následujících možných hodnot. Výchozí hodnota je True. HodnotaPopis False Označuje, že je stav relace zakázán. ReadOnly Označuje, že stav relace není zapisovatelný. True Označuje, že je stav relace povolen.
enableViewState	Volitelný Boolean atributu. Určuje, zda je povolen stav zobrazení a zachován mezi požadavky na stránku. Výchozí hodnota je True.
enableViewStateMac	Nepovinný atribut Boolean. Určuje, zda by technologie ASP.NET měla spustit kód ověřovací zprávy (MAC) ve stavu zobrazení stránky, jakmile je stránka odeslán zpět od klienta. V případě True je kontrolován zašifrovaný stav zobrazení pro ověření, zda nebyl zfalšován v klientském počítači. Výchozí hodnota je True.
maintainScrollPositionOnPostBack	Nepovinný atribut Boolean. Určuje, zda vrátit uživatele na stejnou pozici v klientově prohlížeči, když je stránka odeslána zpět na server. V případě False je při zpětném volání vrácen uživatel na začátek stránky. Tento atribut je v rozhraní .NET Framework verze 2.0 nový. Výchozí hodnota je False.
masterPageFile	Nepovinný atribut String. Určuje relativní cestu stránky předlohy k místnímu konfiguračnímu souboru. Stránky, které mají atribut masterPageFile nastavený na True, musí obsahovat ovládací prvek Content jako ovládací prvek nejvyšší úrovně. Tento atribut je v rozhraní .NET Framework verze 2.0 nový. Výchozí hodnota je prázdný řetězec ("").
maxPageStateFieldLength	Nepovinný atribut Int32. Určuje maximální délku pole stavu stránky ve znacích. Pokud je nastavena na kladné číslo, je pole stavu zobrazení, které je odesláno prohlížeči klienta, rozděleno na bloky menší než velikost, která je uvedena v atributu maxPageStateFieldLength. Pokud je nastavena na záporné číslo, nemělo by být pole stavu zobrazení rozděleno na bloky. Tento atribut je v rozhraní .NET Framework verze 2.0 nový. Výchozí hodnota je "-1".
pageBaseType	Nepovinný atribut String. Určuje základ pro použití, pokud jsou stránky pouze samostatné. Ten je přepsán atributeminherits v samostatném souboru. Výchozí hodnota je "System.Web.UI.Page".
pageParserFilterType	Nepovinný atribut String. Určuje název typu filtru, který používá analyzátor technologie ASP.NET k určení, zda je při analýze položka na stránce povolena. Filtr musí být odvozen od třídy PageParserFilter. Tento atribut je v rozhraní .NET Framework verze 2.0 nový. Výchozí hodnota je prázdný řetězec ("").
smartNavigation	Nepovinný atribut Boolean. Určuje, zda je povolena chytrá navigace. Chytrá navigace vyžaduje aplikaci Microsoft Internet Explorer verze 5.5 nebo novější. Je-li povolena chytrá navigace, získá uživatel následující výhody: Blikání navigace je odstraněno. Pozice posunu na stránce je zachována mezi stránkami. Označení elementu je trvalé mezi stránkami. Poslední stav stránky je pouze stav uchovaný historií prohlížeče. Tento atribut je nový v rozhraní .NET Framework 2.0, však byl označen jako zastaralý ve prospěch atributu maintainScrollPositionOnPostBack. Výchozí hodnota je False.
styleSheetTheme	Nepovinný atribut String. Určuje název složky "pojmenovaný motiv" použité k aplikaci motivu před deklarací ovládacího prvku, na rozdíl od atributu theme, který definuje motiv aplikovaný po deklaraci ovládacího prvku. Tento atribut je v rozhraní .NET Framework verze 2.0 nový. Výchozí hodnota je prázdný řetězec ("").
theme	Nepovinný atribut String. Určuje název motivu, který se používá pro stránky, které jsou v oblasti působnosti konfiguračního souboru. Zadaný motiv musí existovat buď jako motiv aplikace, a nebo jako globální motiv. Pokud motiv neexistuje, je vyvolána výjimka HttpException. Tento atribut je v rozhraní .NET Framework verze 2.0 nový. Výchozí hodnota je prázdný řetězec ("").
userControlBaseType	Nepovinný atribut String. Určuje základ pro použití, pokud jsou stránky pouze samostatné. Výchozí hodnota je "System.Web.UI.UserControl".
validateRequest	Volitelný Boolean atributu. Označuje, že technologie ASP.NET prověří veškeré vstupy z prohlížeče pro potenciálně nebezpečná data. V případě True je provedeno ověření žádosti porovnáním všech vstupních dat vůči seznamu potenciálně nebezpečných hodnot. Dojde-li ke shodě, vyvolá technologie ASP.NET výjimku HttpRequestValidationException. Výchozí hodnota je True.
viewStateEncryptionMode	Nepovinný atribut ViewStateEncryptionMode. Určuje režim šifrování stavu zobrazení. Vlastnost ViewStateEncryptionMode přepíše tento atribut, který je nastaven konfiguračním souboru. Tento atribut může nabývat jedné z následujících možných hodnot. HodnotaPopis Always Stav zobrazení je vždy zašifrován. Auto Stav zobrazení je šifrován, pokud to vyžaduje ovládací prvek. Never Stav zobrazení není nikdy zašifrován. Ani v případě, kdy o to ovládací prvek požádá. Tento atribut je v rozhraní .NET Framework verze 2.0 nový. Výchozí hodnota je Auto.

Podřízené prvky

Prvek	Popis
controls	Definuje kolekci registrovaných direktiv a oborů názvů, kde se předpony značek ukládají.
namespaces	Definuje kolekci direktiv importu použitých během předkompilace sestavení.
tagMapping	Definuje kolekci typů značek, které jsou v době překladu přemapovány na jiný typ značek.
ignoreDeviceFilters	Definuje kolekci prvků zařízení, které musí prohlížeč ignorovat při vykreslení stránky. Další informace naleznete v tématu IgnoreDeviceFilters.

Nadřazené prvky

Prvek	Popis
configuration	Požadovaný kořenový element nacházející se v každém konfiguračním souboru, který je používán modulem CLR (Common Language Runtime) a aplikacemi rozhraní .NET Framework.
system.web	Určuje kořenový element konfiguračního souboru s nastavením konfigurace technologie ASP.NET a obsahuje konfigurační prvky, které konfigurují webové aplikace ASP.NET a řídí chování aplikací.

Poznámky

Element pages definuje nastavení konfigurace specifické pro stránku. Tento oddíl konfigurace podporuje nastavení určité stránky technologie ASP.NET a direktiv ovládacího prvku globálně pro všechny stránky a ovládací prvky v rozsahu konfiguračního souboru. Toto vloží následující direktivy na úrovni stránky, které určují nastavení, která jsou použita kompilátory stránek a uživatelských ovládacích prvků při zpracování stránek webových formulářů ASP.NET (.aspx) a souborů uživatelských ovládacích prvků (.ascx):

Direktiva @ Page (@ Page).
Direktiva @ Import (@ Import) prostřednictvím podřízeného prvku oborů názvů.
Direktiva @ Register (@ Register) prostřednictvím podřízeného prvku ovládacích prvků.

Element pages také poskytuje podporu pro mapování typů značek na jiné typy značek v době běhu pomocí elementu tagMapping.

Poznámka
Přidání direktivy @ Page do stránky předlohy nedovoluje použití stejné deklarace direktivy ve stránkách, které závisí na stránce předlohy.Místo toho použijte konfigurační prvek pages pro globálně definované direktivy stránky.

Výchozí konfigurace

Následující výchozí element pages není explicitně nakonfigurován v souboru Machine.config nebo v kořenovém souboru web.config. To je však výchozí konfigurace, kterou vrací aplikace. Obory názvů a ovládací prvky jsou přidávány v kořenu souboru web.config.

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

Příklad

Následující příklad kódu ukazuje způsob nastavení konfigurace několika stránek.

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

Informace prvku

Obslužná rutina konfiguračního oddílu	PagesSection
Konfigurační člen	Pages Page
Konfigurovatelná umístění	Machine.config Web.config kořenové úrovně Web.config aplikační úrovně Soubor Web.config na úrovni fyzického nebo virtuálního adresáře.
Požadavky	Microsoft Internetová informační služba (IIS) verze 5.0 nebo novější Verze rozhraní .NET Framework 1.0 nebo novější Microsoft Visual Studio 2003 nebo novější

Viz také

Element pages (schéma nastavení ASP.NET)

Atributy a prvky

v případě vícehodnotových atributů

Podřízené prvky

Nadřazené prvky

Poznámky

Výchozí konfigurace

Příklad

Informace prvku

Viz také

Úkoly

Odkaz

Koncepty

Další zdroje

Další materiály