Prozkoumat Razor Pages projekt

• 10 min

V této jednotce použijete .NET Core CLI ke kompilaci a spuštění webové aplikace. Podíváme se na spuštěnou aplikaci, abyste pochopili možnosti uživatelského rozhraní, které poskytuje.

Kontrola projektu

adresář projektu RazorPagesPizza je v editoru Visual Studio Code aktuálně otevřen. Následující tabulka popisuje soubory projektu a adresáře zajímavosti. každý z nich prověřte v okně editor Visual Studio Code.

Soubory stránky Razor a jejich spárované soubory PageModel třídy

podle konvence je adresář stránky , kde jsou všechny Razor Pages uloženy a uspořádány v ASP.NET Core aplikaci.

Stránka Razor má příponu souboru . cshtml . Podle konvence, jeho přidružený PageModel soubor třídy jazyka C# používá stejný název, ale s připojeným příponou. cs . Například index stránky Razor . cshtml má přidružený PageModel soubor třídy pro index. cshtml. cs.

Objekt modelu definuje vlastnosti dat a zapouzdřuje logiku nebo operace související s těmito vlastnostmi dat. PageModel je prakticky stejný, jedná se ale o model, který zapouzdřuje konkrétně vlastnosti dat a logické operace pouze v oboru své stránky Razor Page. Třída PageModel:

• Umožňuje oddělení logiky stránky Razor z její prezentace.
• Definuje obslužné rutiny stránky pro požadavky odeslané na stránku a pro data použitá k vykreslení stránky.

Obslužná rutina stránky je metoda, která se spustí v důsledku požadavku HTTP. Například OnGet metoda v třídě stránky Razor PageModel se automaticky spustí pro požadavek HTTP GET.

Stránky/sdílený adresář

Částečné prvky značek, které jsou sdíleny napříč několika stránkami Razor, jsou umístěny v konvenci v umístění stránky nebo sdíleného adresáře. aplikace RazorPagesPizza používá dvě sdílená částečná zobrazení, která jsou součástí při vytváření nového projektu webové aplikace ASP.NET Core :

• _Layout. cshtml: poskytuje společné prvky rozložení napříč více stránkami.
• _ValidationScriptsPartial. cshtml: poskytuje funkce ověřování, jako je ověřování vstupu formuláře na straně klienta a ověřování proti padělání mezi weby. Toto částečné zobrazení je k dispozici pro všechny stránky v projektu.

Rozložení a soubory částečného zobrazení

• rozložení: v ASP.NET Core jsou rozložení soubory . cshtml , které definují šablonu nejvyšší úrovně pro zobrazení v aplikaci. Aplikace nevyžadují rozložení. Aplikace mohou definovat více než jedno rozložení s různými zobrazeními určujícími různá rozložení. Většina webových aplikací má běžné rozložení, které poskytuje konzistentní uživatelské prostředí. Rozložení obvykle zahrnuje běžné prvky uživatelského rozhraní, jako jsou záhlaví aplikace, navigace nebo prvky nabídky a zápatí. Mnoho stránek v aplikaci také často používá běžné struktury HTML, jako jsou skripty a šablony stylů. Všechny tyto sdílené prvky mohou být definovány v souboru rozložení, na který pak může odkazovat jakékoli zobrazení použité v aplikaci. Rozložení omezují výskyt duplicitního kódu v zobrazeních.

• Částečné zobrazení: částečné zobrazení je soubor označení Razor (. cshtml), který VYKRESLUJE výstup HTML v rámci jiného vykresleného výstupu souboru s označením. Částečná zobrazení slouží k rozdělení velkých označovacích souborů na menší součásti. Dále omezují duplicity běžného obsahu kódu v označovacích souborech. Částečná zobrazení nejsou použita k údržbě běžných prvků rozložení. Společné prvky rozložení jsou zadány v souboru _Layout. cshtml .

Rozložení a částečná zobrazení nejsou předmětem tohoto modulu. Na konci modulu jsou k dispozici odkazy, které povedou hlubší podrobně funkcí a konceptů, které jsou zde zavedeny.

Struktura adresáře Pages a požadavky na směrování

Razor Pages používá adresářovou strukturu v adresáři stránek jako konvence pro požadavky směrování ve výchozím nastavení. Stránka indexu umístěná v kořenu adresáře stránky je například výchozí stránkou pro lokalitu aplikace. V adresáři stránky/produkty projektu RazorPagesPizza najdete kolekci stránek Razor, včetně stránky index. cshtml . Požadavky směrované na /Product/ budou směrovány, aby používaly výchozí index. cshtml Page fyzicky umístěný na Products/index. cshtml, například. Stránky Razor (. cshtml) a doprovodné PageModel třídy (. cshtml. cs) projektu se na stránkách nebo v produktech seskupují pohodlně. Všechny předané hodnoty parametrů tras jsou zpřístupněny prostřednictvím vlastnosti. ASP.NET Core nabízí robustní funkce směrování.

Následující tabulka uvádí trasy, které se mají použít v dokončeném projektu tohoto modulu.

Kontrola znalostí