ASP.NET Core Razor頁面用法介紹

Posted on by

簡介

隨著ASP.NET Core 2 即將來臨，最熱門的新事物是Razor頁面。在之前的一篇文章中，我們簡要介紹瞭ASP.NET Core Razor 頁面。

Razor頁面是ASP.NET Core的一個新功能，可以使基於頁面的編程方式更容易，更高效。

大眾的初步印象是對於那些隻專註於頁面的小型應用來說，Razor頁面更容易、更快地取代MVC。然而，事實證明，它可能比這更強大。使用ASP.NET Core 2在創建新的應用程序時，Razor頁面（空，Razor頁面，Web API，MVC）是默認選項，似乎ASP.NET團隊對Razor頁面有更多的計劃，並希望它成為創建Web應用程序時首選。

所有的Razor頁面類型和特征都在Microsoft.AspNetCore.Mvc.RazorPages程序集中，MVC默認包Microsoft.AspNetCore.Mvc已經包含瞭Razor頁面組件，這意味著您可以在MVC應用程序中直接使用Razor頁面。

Razor頁面的優點之一是設置和創建非常容易。您創建一個新的空項目，添加Pages文件夾，添加頁面，隻需在 .cshtml 文件中編寫代碼和標記。非常適合新手，是學習ASP.NET Core簡單快速的方法！

Why？

如果您想使用MVC構建幾個簡單的頁面，你需要將控制器 Action、HTML視圖、視圖模型、路由分別在單獨的位置編寫，這看起來似乎很過分瞭。

在Razor頁面中，隻有一個Razor文件（.cshtml），後臺的代碼也位於該文件內，該文件也表示應用程序的URL結構（稍後將會介紹）。因此，您可以將所有內容都放在一個文件中，就這麼簡單。

但是，您可以使用 .cshtml.cs 擴展名文件將後臺代碼分開。通常在該文件中包括視圖模型和Handlers （如MVC中的Acion方法），也可以在該文件中的處理邏輯。當然，您也可以將您的視圖模型移動到單獨的文件中。

創建Razor頁面應用程序

在VS 2017中安裝.NET Core 2 SDK的情況下，如果我們按照這樣的方式：文件 – > 新建項目 – > Web – > ASP.NET Core Web應用程序，我們將得到下面的窗口：

手動將身份驗證類型改為“個人用戶帳戶”。

我們也可以通過CLI實現同樣的效果

dotnet new razor --auth Individual

在dotnet CLI創建一個新項目之後，我們將在的項目中得到以下結構：

首先註意到是沒有Views文件夾, 如果沒有選擇"授權"選項, 那麼也不會有"Controllers"文件夾。在我們的例子中，有AccountController控制器，在 Pages 文件夾中包含Account 文件夾。該文件夾的中，我們存放Razor頁面，在MVC中這些代碼通常放在 ~Views/Account 文件夾中：

頁面的默認位置是"Pages"文件夾，但可以更改

大部分頁面都附帶.cs文件，表示頁面的模型:

在.cs文件中，我們可以定義我們的邏輯、Handlers（Action）、模型和所有需要的邏輯。我們也可以把它當作是.cshtml頁面的粘合劑，僅處理GET / POST / PUT / DELETE，也可以將邏輯移到單獨的類或層/項目中。

需要註意的一點是，我們需要在 .cshtml 文件的頂部定義 @page 指令。這告訴Razor這個 .cshtml 文件是Razor Page文件：

ASP.NET Core Razor頁面 – 核心功能

由於Razor頁面是MVC框架的一部分，我們可以在Razor頁面中使用MVC所附帶的任何功能。

模型綁定

在MVC中模型綁定也適用於Razor頁面，就像MVC控制器中的Action方法一樣，在Razor頁面代碼有Handlers 。

在ChangePassword頁面.cshtml文件編寫如下表單：

ChangePassword.cshtml.cs文件中實現ChangePasswordModel類：

這裡是InputModel類：

InputModel提供瞭我們在MVC中熟悉的ViewModel功能。

Handlers

我們使用Handlers作為處理HTTP請求（GET，POST，PUT，DELETE ..）的方法。例如，我們可以有以下方法：

  • OnGet / OnGetAsync
  • OnPost / OnPostAsync
  • OnDelete / OnDeleteAsync

這些方法將由ASP.NET Core根據HTTP請求的類型自動匹配。

讓我們回到之前ChangePassword的示例。這是ChangePassword.cshtml.cs文件的一部分代碼：

OnGetAsync和OnPostAsync是Razor頁面 handlers約定好瞭的名稱。一旦您打開ChangePassword頁面，OnGetAsync handler 將執行，當您從ChangePassword.cshtml頁面提交表單，OnPostAsync handler 將被觸發。

此外，我們可以將所有的頁面代碼放在 .cshtml 文件中。例如，我們可以將這兩個函數從ChangePassword.cshtml.cs文件移動到ChangePassword.cshtml中：

關鍵字 @functions 指令，它使Razor文件范圍內的代碼成為功能級方法。

Tag Helpers and HTML Helpers

我們還可以在Razor頁面內使用所有現有的Tag Helpers 和HTML Helpers；此外，可以創建自定義的幫助類，並在Razor頁面中使用它們。

路由

我在GitHub中的小項目設置演示瞭如何使用Razor頁面進行CRUD – 倉庫鏈接 。您需要.NET Core 2.0 preview 3（build 6764 才能正常運行）或更高版本以及Visual Studio 2017.3或更高版本。

以下是所有文件的項目結構：

除瞭兩個標準文件 Program.cs 和 Startup.cs ，一切都在Pages文件夾中；請註意，某些頁面具有匹配的後臺代碼文件。

如前所述，項目中頁面的位置（文件系統中的路徑）將確定匹配的URL。

這裡是一些重要頁面文件和路由匹配的列表：

頁面文件路徑 匹配的URL
~Pages/Index.cshtml / ， /Index
~Pages/Categories/Index.cshtml /Categories ， Categories/Index
~Pages/Categories/Edit.cshtml /Categories/Edit/1
~Pages/Categories/Create.cshtml /Categories/Create

總結

  • Razor頁面是以網頁為重點的Web編程方式
  • 您可以（如果您想）在一個文件中實現所有的代碼和HTML
  • Razor頁面文件的路徑決定瞭您的頁面的URL/路由
  • 這不是老的ASP.NET網頁的新實現
  • 在MVC中可以使用的的功能，我們也可以Razor頁面中使用：
    • 模型綁定
    • Razor支持
    • Tag Helpers
    • HTML Helpers
    • Handlers (Action方法)
    • 等等…
  • 我們有（OnGet，OnGetAsync，OnPostAsync等）Handlers
  • 文件系統（項目結構）中的頁面位置決定URL路徑
  • 需要一個根文件夾
  • 默認存儲在 Pages 根文件夾中（可配置）

到此這篇關於ASP.NET Core Razor頁面用法介紹的文章就介紹到這瞭。希望對大傢的學習有所幫助，也希望大傢多多支持WalkonNet。

推薦閱讀：