Tento článek byl přeložený strojově. Pokud chcete zobrazit článek v angličtině, zaškrtněte políčko Angličtina. Anglickou verzi článku můžete také zobrazit v místním okně přesunutím ukazatele myši nad text.
Překlad
Angličtina

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

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

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" 
   renderAllHiddenFieldsAtTopOfForm="[True|False]"
   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>

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

Attributes

Atribut

Popis

asyncTimeout

Nepovinný atribut TimeSpan.

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 ASP.NET Server Control Event Model.

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 ASP.NET Control Identification.

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í je Always.

Value Popis
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.

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

Atribut enableSessionState může nabývat jedné z následujících možných hodnot. Výchozí hodnota je True.

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

Nepovinný atribut Boolean.

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 ("").

renderAllHiddenFieldsAtTopOfForm

Nepovinný atribut Boolean.

Určuje, zda jsou vykresleny všechny generované systémem skrytých polí v horní části formuláře.

Tento atribut je v rozhraní .NET Framework verze 3.5 nový.

Výchozí hodnota je True.

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

Nepovinný atribut Boolean.

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.

Value Popis
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.

Child Elements

Element

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.

Parent Elements

Element

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

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

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

Note Note

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>

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>

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

Zobrazit: