@ Page

Definuje atributy specifické pro danou stránku (soubor ASPX) používá ASP.Analyzátor ČISTÉ stránky a kompilátoru.

<%@ Page attribute="value" [attribute="value"...] %>

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

• Async
  Vytvoří stránku asynchronní popisovač (, způsobuje stránky pomocí implementace IHttpAsyncHandler ke zpracování požadavků).

  Výchozí hodnota je false.

• AsyncTimeOut
  Určuje časový interval (v sekundách) používané při zpracování asynchronních úkoly. Výchozí hodnota je 45 sekund.

  Hodnota musí být celé číslo.

  Další informace naleznete AsyncTimeout vlastnost.

• AspCompat
  Pokud true, umožňuje stránky v podprocesu jedním podprocesem apartment (STA). Díky stránce volat STA součásti, například komponenty vyvinuté s Microsoft Visual Basic 6.0. Nastavení tohoto atributu na true také umožňuje stránky volat verze 1.0 součásti COM +, které vyžadují přístup do nespravovaného stránek ASP (Active Server) předdefinovaných objektů. Jsou přístupné prostřednictvím ObjectContext objektu nebo OnStartPage metody. Výchozí hodnota je false.

  Poznámka
  Nastavení tohoto atributu na true mohou způsobit snížit výkon dané stránky.Další informace naleznete v části Poznámky.

• AutoEventWireup
  Označuje, zda budou události na stránce autowired. true značí zda je povoleno automatického napojení události, v opačném případě false. Výchozí hodnota je true. Další informace naleznete v tématu Model událostí ovládacích prvků webového serveru technologie ASP.NET.

• Buffer
  Určuje, zda je povoleno ukládání odpovědí HTTP. truePokud je povoleno ukládání stránky; jinak false.

  Výchozí hodnota je true.

• ClassName
  Řetězec určující název třídy stránky, který bude dynamicky zkompilován při požadavku na stránku. Tato hodnota může být libovolný platný název třídy a může obsahovat třídu plně kvalifikovaný název. Pokud nezadáte hodnotu atributu název třídy pro kompilované stránky založené na názvu souboru stránky a používá výchozí obor názvů ASP. Pokud hodnota ClassName je atribut zadán bez úplné oboru názvů poté obor názvů ASP je použita, společně s názvem třídy určené k vytvoření třídy plně kvalifikovaný název.

  Může odkazovat na jinou stránku na první stránce přiřadit pomocí názvu třídy @ Odkaz směrnice.

  Poznámka

  Je možné ve třídě kódem na pozadí stránky odkaz členy třídy stránky ASPX spojeny pomocí plně kvalifikovaného názvu stránku ASPX.Však pokud precompile serveru s povolenou ochranou zdroje, kódem na pozadí stránky třídy se nenachází ve stejném sestavení jako třída stránku ASPX.Odkaz na třídu v souboru s kódem na pozadí proto nebude pracovat.Další informace na precompilation Přehled o předkompilaci technologie ASP.NET.

• 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 ClientID dané stránky. Lze nastavit různé výchozí hodnoty stránky prvek souboru Web.config. Další informace o algoritmech naleznete ClientIDMode Třída

• ClientTarget
  ASP, které určuje cíl uživatelského agenta (obvykle webového prohlížeče, jako je například aplikace Microsoft Internet Explorer).Ovládací prvky serveru NET by vykreslení obsahu. Tato hodnota může být libovolný platný alias definované v rámci <clientTarget> části konfigurační soubor aplikace. Další informace naleznete ClientTarget vlastnost.

• CodeBehind
  Určuje název zkompilovaného souboru, který obsahuje třídy přidružené stránce. Tento atribut není použit v době běhu.

  Tento atribut se používá pro webové aplikace projekty. CodeFile Atribut je použit pro projekty webu. Další informace o typech webového projektu v aplikaci Visual Studio, viz Projekty webových aplikací versus webové projekty.

• CodeFile
  Určuje cestu k souboru odkazovaného kódem na pozadí stránky. Tento atribut je použit společně s Inherits atribut přidružení souboru zdroje kódem na pozadí webové stránky. Atribut je platný pouze pro kompilované stránky.

  Tento atribut slouží pro projekty na webu. CodeBehind Atribut je použit pro webové aplikace projekty. Další informace o typech webového projektu v aplikaci Visual Studio, viz Projekty webových aplikací versus webové projekty.

• CodeFileBaseClass
  Určuje název typu základní třídy pro stránku a její přidružené kódem na pozadí. Tento atribut je volitelný, ale v případě použití atributu CodeFile musí být také přítomen. Použít tento atribut implementace sdílené scénář, kde můžete definovat společná pole (a volitelně přidružené události) v základní třídě odkazovat na ovládací prvky deklarované webové stránky. Z důvodu ASP.ČISTÝ kód generování modelu definovaných polí v základní třídě bez použití tohoto atributu, při kompilaci by nové definice členské generovaná pro ovládací prvky deklarované webové stránky (v rámci samostatné dílčí třídy inzerováním) a nebude požadovaný scénář. Ale pokud použijete CodeFileBaseClass atribut základní třídy přidružení stránky a provádět částečné třídy (jeho název je přiřazen Inherits atributu a jeho zdrojový soubor odkazuje CodeFile atributu) dědí ze základní třídy, pak pole v základní třídě budou moci odkazovat na ovládací prvky na stránce po generování kódu.

• CodePage
  Určuje hodnotu schéma kódování používané pro odpověď. Hodnota je celé číslo, které slouží jako Identifikátor schématu kódování. Seznam možných CodePage ID najdete Encoding Třída

• CompilationMode
  Nastaví, zda je třeba sestavit stránky, pomocí řetězec, který určuje jednu z několika možností výčtu. Výchozí hodnota je Always, takže stránky ASPX jsou kompilovány při výchozím nastavení. Další informace naleznete ve výčtu CompilationMode.

• CompilerOptions
  Řetězec obsahující možnosti kompilátoru používané ke kompilování stránky. V jazyce C# a Visual Basic je to sekvence přepínačů příkazového řádku kompilátoru. Více informací o možnostech kompilátoru naleznete v Možnosti C# kompilátoru nebo Visual Basic Compiler.

• ContentType
  Definuje jako standardní typ MIME Typ obsahu HTTP odpovědi. Podporuje libovolný platný řetězec typu obsahu protokolu HTTP. Seznam možných hodnot, hledání MIME v Knihovny MSDN.

• Culture
  Udává nastavení kultury pro stránku. Hodnota tohoto atributu musí být platný kultury ID. Všimněte si, že LCID a Culture atributy se vzájemně vylučují; Pokud používáte některý z těchto atributů, ostatní nelze použít na stejné stránce. Další informace o naleznete Culture vlastnost a CultureInfo Třída

• Debug
  Označuje, zda stránka být zkompilován symboly ladění. truePokud stránka být zkompilován symboly ladění; jinak false. Protože toto nastavení ovlivňuje výkon, měli byste vždy během vývoje nastavit atribut na true.

• Description
  Obsahuje popis stránky. Tato hodnota je ignorována analyzátorem technologie ASP.NET.

• EnableEventValidation
  Umožňuje ověření události v případech zpětného odeslání a zpětné volání. truePokud jsou ověřovaný události; jinak false. Výchozí hodnota je true.

  Stránka Ověření události snižuje riziko neoprávněné požadavky vyvolávají a zpětná volání. Když enableEventValidation je nastavena na true, ASP.NET umožňuje pouze události, které lze zvýšit o kontrole během zpětného odeslání požadavku nebo zpětné volání. Ovládací prvek s tímto modelem registruje jeho události během vykreslování a ověřuje události, při zpracování prvků nebo zpětné volání. Všechny události řízené prvky v prostředí ASP.NET use ve výchozím nastavení této funkce.

  Je velmi doporučováno nezakazovat ověřování událostí. Před zakázáním ověření události je třeba jisti, že nebylo vyrobeno bez zpětného odeslání, by mít nežádoucí vliv na aplikace.

• EnableSessionState
  Definuje požadavky na stránce Stav relace. truePokud je stav relace povolen; ReadOnlyPokud je stav relace lze číst, ale nezmění; jinak false. Výchozí hodnota je true. Tyto hodnoty jsou rozlišována malá a velká písmena. Další informace naleznete v tématu Přehled stavu relace ASP.NET.

• EnableTheming
  Označuje, zda jsou na stránce použity motivy. true pokud se používají motivy; v opačném případě false. Výchozí hodnota je true.

• EnableViewState
  Určuje, zda stav zobrazení je zachována u všech požadavků na stránky. Tato hodnota je true -li stav zobrazení je zachován, nebo false -li stav zobrazení není zachován. Výchozí hodnota je true.

  I když je tato vlastnost nastavena na true, stav zobrazení budou zachovány pro ovládací prvek, pokud platí některá z následujících podmínek:

  • Ovládacího prvku EnableViewState je nastavena na false.

  • Ovládacího prvku ViewStateMode je nastavena na Disabled nebo zdědí ovládací prvek Disabled hodnotu.

  Zobrazit další informace o zobrazení stavu a stavu řízení Control.EnableViewState vlastnost.

• EnableViewStateMac
  Označuje prostředí ASP.NET ověřte kódů pro ověřování zpráv (MAC) ve stavu zobrazení stránky při odeslání stránky zpět od klienta. trueJestliže stav zobrazení by měla být kontrolována; MAC jinak false. Výchozí hodnota je true.

  MAC stavu zobrazení je šifrovanou verzí skryté proměnné, který je uložen stav zobrazení stránky při odeslání do prohlížeče. MAC se používá k ověření, že stav zobrazení není byla změněna na straně klienta.

  Poznámka k zabezpečení
  Tento atribut je třeba nastavit nikdy na false v produkci webu.

• ErrorPage
  Definuje cílovou adresu URL pro přesměrování stránky Neošetřená výjimka vyskytne. Další informace naleznete ErrorPage vlastnost.

• Explicit
  Určuje, zda je stránka zkompilována pomocí režimu Option Explicit jazyka Visual Basic. true označuje, že je povolena explicitní volba kompilace jazyka Visual Basic a že všechny proměnné musí být deklarovány pomocí Dim, Private, Public nebo ReDim, jinak false. Výchozí hodnota je false.

  Poznámka
  Tento atribut je ignorován v jiných jazycích než je jazyk Visual Basic.Také tato možnost je nastavena na hodnotu true v konfiguračním souboru Machine.config. Další informace naleznete v tématu Konfigurační soubory technologie ASP.NET.

• Inherits
  Definuje třídu kódem na pozadí stránky dědí. Může to být libovolné třídy odvozené z Page Třída Atribut se použije CodeFile atribut, který obsahuje cestu k souboru zdroje pro třída kódem na pozadí Inherits Atributu je malá a velká písmena při použití C# jako jazyk stránky a case-insensitive při použití jazyka Visual Basic jako jazyk stránky.

  Pokud Inherits atributu nesmí obsahovat obor ASP.NET kontroly zda ClassName obsahuje atribut namespace. Pokud ano, ASP.NET se pokusí načíst třídu odkazuje Inherits atributu pomocí oboru názvů ClassName atributu. (To předpokládá, že Inherits atribut a ClassName i atribut použít stejný obor názvů.)

  Další informace o třídách s kódem na pozadí v tématu Model kódu webové stránky ASP.NET.

• Language
  Určuje jazyk, který je použit při kompilaci všech vložených vykreslení (<% %> a <%= %>) a bloků deklarace kódu ve stránce. Hodnoty mohou představovat jakékoli podporované jazyky platformou .NET Framework včetně Visual Basic, C# nebo JScript. Lze použít pouze jeden jazyk a zadané na stránce.

• LCID
  Určuje identifikátor národního prostředí pro stránky webových formulářů.

  Poznámka

  Identifikátor národního prostředí je 32bitová hodnota, která jednoznačně určuje národní prostředí.PROSTŘEDÍ ASP.NET používá výchozí národní prostředí webového serveru, pokud nezadáte jiné národní prostředí stránky webových formulářů pomocí tohoto atributu.Všimněte si, že LCID a Culture atributy se vzájemně vylučují; Pokud používáte některý z těchto atributů, ostatní nelze použít na stejné stránce.Další informace o národní prostředí Knihovny MSDN.

• LinePragmas
  Určuje, zda by měl modul runtime generovat direktivy řádku do zdrojového kódu. Toto jsou možnosti kompilátoru, které jsou často používány ladicími nástroji k označení určitého místa ve zdrojovém souboru. true, zda má být direktiva řádku vygenerována; v opačném případě false.

• MaintainScrollPositionOnPostback
  Označuje, zda uživatel vrátit do stejné polohy v prohlížeči klienta po zpětné odeslání. truePokud uživatelé by měla být vrácena do stejné polohy; jinak false. Výchozí hodnota je false.

  Poznámka
  Vývojáři můžete definovat nastavením tohoto atributu pro všechny stránky maintainScrollPostitionOnPostback atributu (Všimněte si, že je velká a malá písmena v konfiguračních souborech) na <pages> prvek souboru Web.config.

• MasterPageFile
  Nastaví cestu ke vzorové stránce obsahu stránky nebo vnořené stránce předlohy. Podporuje relativní a absolutní cesty. Další informace naleznete MasterPageFile vlastnost.

• MetaDescription
  Nastaví MetaDescription vlastnost. Pokud poznámky stránky obsahuje také "popis" metaprvek, hodnota @ Page směrnice přepíše hodnota značky.

• MetaKeywords
  Nastaví MetaKeywords vlastnost. Pokud "klíčová slova" zahrnuje také poznámky stránky metaprvek, hodnota @ Page směrnice přepíše hodnota značky.

• ResponseEncoding
  Označuje název schéma kódování používané pro odpověď HTTP obsahující obsah stránky. Hodnotu přiřazenou tomuto atributu je neplatný název kódování. seznam možných kódování jmen, naleznete Encoding Třída Můžete také zavolat GetEncodings Metoda seznam možných kódování názvy a identifikátory.

• SmartNavigation
  Označuje, zda stránka podporuje funkci Inteligentní navigace aplikace Internet Explorer 5.5 nebo novější. truePokud je povolena inteligentní navigace; jinak false. Výchozí hodnota je false.

  V prostředí ASP.NET verze 2.0 a novější, SmartNavigation vlastnost je zastaralá. Použití SetFocus Metoda a MaintainScrollPositionOnPostback() vlastností namísto.

• Src
  Určuje cestu k zdrojový soubor obsahující kód, který je propojen na stránku. V souboru propojený zdroj můžete zahrnout programovací logiku stránky ve třídě nebo v prohlášení bloky kódu.

  Můžete použít Src propojení atributu sestavit poskytovatelům stránky. Další informace naleznete BuildProvider Třída Také ve verzích prostředí ASP.NET před na 2.0, Src atributu byl použit jako alternativní způsob propojení souboru kódem na pozadí stránky. V prostředí ASP.NET 2.0 je vhodnější k propojení zdrojového souboru kódem na pozadí stránky použít Inherits atribut určete třídu, spolu s CodeFile atributu zadat cestu k zdrojový soubor třída

• Strict
  Označuje, že stránky třeba sestavit jazyka Visual Basic Option Strict režimu. true, pokud je Option Strict povoleno; jinak false. Výchozí hodnota je false.

  Poznámka
  Tento atribut je ignorován v jiných jazycích než je jazyk Visual Basic.

• StyleSheetTheme
  Určuje identifikátor platný motiv použít na stránce. Když StyleSheetTheme je nastaven atribut, jednotlivé ovládací prvky můžete potlačit nastavení Stylistické obsažené v motivu. Tedy motiv může poskytnout celkový vzhled webu, při nastavení obsažená ve StyleSheetTheme atribut umožňují přizpůsobit konkrétní nastavení stránky a její jednotlivé prvky.

• TargetSchema
  Určuje název schématu ověření obsahu na stránce. Toto slouží pouze k popisnému účelu; není provedeno žádné skutečné ověřování a atribut je analyzátorem ignorován.

• Theme
  Určuje identifikátor platný motiv použít na stránce. Když Theme nastaven atribut bez použití StyleSheetTheme atribut potlačí nastavení individuální styl ovládacích prvků umožňuje vytvořit jednotný a konzistentní vzhled na stránce. Další informace naleznete Theme vlastnost.

• Title
  Určuje název stránky, poskytnuté v rámci HTML <title> značky v odpovědi. Název lze přistupovat také programově jako vlastnost stránky. Podrobnosti najdete Title vlastnost.

• Trace
  Označuje, zda je povoleno sledování. truePokud je povoleno sledování; jinak false. Výchozí hodnota je false. Další informace naleznete v Přehled trasování technologie ASP.NET a Trace vlastnost.

• TraceMode
  Určuje, jak budou zobrazeny na stránce při trasování povoleno trasovací zprávy. Možné hodnoty jsou SortByTime a SortByCategory. Ve výchozím nastavení, pokud je povoleno sledování SortByTime. Další informace o možnosti trasování získáte v tématu Přehled trasování technologie ASP.NET.

• Transaction
  Označuje, zda jsou transakce COM + na stránce. Possible values are Disabled, NotSupported, Supported, Required, and RequiresNew. Výchozí hodnota je Disabled.

• UICulture
  Určuje nastavení uživatelského rozhraní (UI) kultury pro stránku. Podporuje libovolnou hodnotu platnou kultury uživatelského rozhraní. Další informace naleznete UICulture vlastnost.

• ValidateRequest
  Označuje, zda by dojít k ověření požadavku. Pokud true, žádost o ověření kontroly všechna vstupní data proti pevně seznam potenciálně nebezpečných hodnot. Pokud dojde ke shodě HttpRequestValidationException je výjimka. Výchozí hodnota je true.

  Tato funkce povolena v konfiguračním souboru počítač (Machine.config). Můžete jej zakázat v konfiguračním souboru aplikace (Web.config) nebo na stránce nastavením tohoto atributu na false.

  Poznámka

  Tato funkce pomáhá snížit riziko útoky prostřednictvím skriptování mezi servery pro jednoduché stránky a ASP.NET aplikací.Aplikace, která nesprávně ověřuje vstup uživatele můžete trpí mnoho typů chybně vstupní útoků včetně skriptování a útoky vkládáním příkazu Microsoft SQL Server.Neexistuje náhradu pečlivě všechny formuláře v aplikaci vstupní hodnocení a ujistěte se, že jsou buď řádně validovány nebo kódování nebo že aplikace je uvozena před ke zpracování dat nebo odesílání informací zpět klientovi.

• ViewStateEncryptionMode
  Určuje, jak je stav zobrazení zašifrované pomocí tří možných hodnot výčtu: Auto, Always nebo Never. Výchozí hodnota je Auto, což znamená, že stav zobrazení budou šifrovány jednotlivého ovládacího prvku požadavků jej. Další informace naleznete ViewStateEncryptionMode výčtu.

• ViewStateMode
  Určuje, ViewStateMode se projeví u ovládacího prvku hodnotu vlastnosti při ViewStateMode vlastnost ovládacího prvku je Inherit. Výchozí ViewStateMode hodnota stránky je Enabled.

  ViewStateMode a EnableViewState Vlastnosti určují, zda stav zobrazení je zachována pro ovládací prvky na stránce. Další informace naleznete EnableViewState Vlastnosti a ViewStateMode vlastnost.

• WarningLevel
  Označuje úroveň pro upozornění kompilátoru, kdy chcete zpracovávat upozornění jako chyby kompilátoru tedy přerušování sestavení stránky. Možné úrovně pro upozornění jsou 0 až 4. Další informace naleznete WarningLevel vlastnost.

Poznámky

Tato směrnice lze použít pouze v stránkách webových formulářů. Zahrnout pouze jednu @ Page směrnice za souboru ASPX. Dále lze definovat pouze jeden Language atribut za @ Page směrnice, protože pouze jeden jazyk lze na stránce. Protože nejčastěji používané výchozích hodnot pro většinu atributů ve zdrojovém kódu nebo v konfiguračních souborech je často zbytečné směrnice přidat velkou sadu atributů. Obecně byste měli přidat minimální sadu atributů požadovaných funkcí požadované stránky. Pokud společná atribut, který chcete použít na všechny stránky, například pokud chcete povolit trasování na všech stránkách, zvažte povolení funkce v souboru Web.config místo přidání Trace atributu pro každé jednotlivé stránky.

Poznámka
@ Page Směrnice má několik atributů společné s jiných směrnic, které platí pro celý zdrojový soubor, například @ Control (používán pro ovládací prvky uživatele webové soubory ASCX) směrnice a @ Hlavní směrnice (používané v souborech .master stránek předlohy).

Definovat více atributů @ Page směrnice, oddělte každou dvojici atribut/hodnota jednoho místa. Pro určitý atribut nezahrnujte mezeru na obou stranách symbolu rovná se (=), který spojuje atribut s jeho hodnotou. Příklad naleznete v oddílu Příklad tohoto tématu.

Inteligentní navigace je ASP.NET funkce podporována v aplikaci Internet Explorer 5.5 a novější prohlížeče. Stránka může být aktualizována při zachování pozice posuvníku a prvek fokus mezi navigací příčinou jedné stránky uložené v historii prohlížeče a bez společné blikání přidružené k aktualizaci webové stránky umožňuje. Inteligentní navigace je nejvhodnější pro prostředí ASP.NET stránek, které vyžadují časté postbacks však vrátit na výrazně změnit vizuální obsah. Pečlivě to při rozhodování, zda atribut na true.

Když AspCompat atribut nastaven na true stránky, pokud použijete konstruktor vytvořit komponentu modelu COM před plánovaným žádost bude spuštěn v podprocesu typu apartment s více podprocesy (MTA). Tento postup způsobuje významné snížení výkonu serveru WWW. Tomuto problému se vyhnete vytváření komponent modelu COM z pouze uvnitř jedné z Page události (například Page_Load, Page_Initatd) nebo Page metod. Ujistěte se také, že objekty nejsou vytvořeny v době konstrukce stránky.

Následující příklad kódu ukazuje doporučený způsob vytvoření instance objektu COM na stránce s AspCompat povolena.

<%@ Page AspCompat="true" language="C#" %>
<script runat="server" >

MyComObject comObj;

public void Page_Load(){
   // Use comObj here when the code is running on the STA thread pool.
   comObj = New MyComObject();
   // Do something with the combObj object.
}

<%@ Page AspCompat="true" language="VB" %>
<script runat="server" >

    Dim comObj As MyComObject 

    Public Sub Page_Load()
     'Use comObj here when the code is running on the STA thread pool.
     comObj = New MyComObject()
     ' Do something with the combObj object.
    End Sub
</script>

Poznámka
Přidání @ Master ke stránce předlohy směrnice neumožňuje používat stejné směrnice prohlášení stránek, které závisí na hlavní.Místo toho použijte stránky prvku definovat stránku směrnic globálně.

Příklad

Následující příklad kódu pokyn ASP.Kompilátor ČISTÉ stránky pomocí jazyka Visual Basic jako kód na straně serveru jazyk pro stránku a nastaví výchozí HTTP MIME ContentType klientovi předávány atribut "text/xml".

<%@ Page Language="VB" ContentType="text/xml" %>

Viz také

Odkaz

Syntaxe šablony textu směrnice

@ Control

@ Master

Další zdroje

Syntaxe stránky [ASP.NET]