ASP.NET Core Razor Pages 初探

来源:https://www.cnblogs.com/kklldog/archive/2020/04/27/core-razor-page.html
-Advertisement-
Play Games

最近新建 Asp.net Core MVC 項目的時候不小心選錯了個模板，發現了一種新的項目模板。它使用cshtml視圖模板，但是沒有Controller文件夾。後來才發現這是ASP.NET Core框架新推出的Razor Pages技術。 什麼是Razor Pages “Razor Pages 使 ...


最近新建 Asp.net Core MVC 項目的時候不小心選錯了個模板，發現了一種新的項目模板。它使用cshtml視圖模板，但是沒有Controller文件夾。後來才發現這是ASP.NET Core框架新推出的Razor Pages技術。

什麼是Razor Pages

“Razor Pages 使編碼更加簡單更加富有生產力”這是微軟說的==！。Razor Pages 簡化了傳統的mvc模式，僅僅使用視圖跟模型來完成網頁的渲染跟業務邏輯的處理。模型里包含了數據跟方法，通過綁定技術跟視圖建立聯繫，這就有點像服務端的綁定技術。下麵使用一個標準的CRUD示例來演示Razor Pages的開發，並且簡單的探索一下它是如何工作的。

新建Razor Pages項目

在visual studio中新建Razor Pages項目。

項目結構

新建項目的目錄結構比MVC項目簡單。它沒有Controllers目錄，Pages有點像MVC項目的Views目錄，裡面存放了cshtml模板。隨便點開一個cshtml文件，發現它都包含了一個cs文件。這是跟MVC項目最大的不同，這個結構讓人回憶起那古老的WebForm技術，o(╥﹏╥)o 。

新建Razor Page

我們模擬開發一個學生管理系統。一共包含4個頁面：列表頁面、新增頁面、修改頁面、刪除頁面。首先我們新建一個列表頁面。
在Pages目錄下麵新建Student目錄。在Student目錄下新建4個Razor page名叫：List、Add、Update、Delete。

建好後目錄結構是這樣：

模擬數據訪問倉儲

由於這是個演示項目，所以我們使用靜態變數來簡單模擬下數據持久。
在項目下新建一個Data目錄，在目錄下新建Student實體類：

    public class Student
    {
        public int Id { get; set; }
        public string Name { get; set; }

        public string Class { get; set; }

        public int Age { get; set; }

        public string Sex { get; set; }
    }

在Data目錄下新建IStudentRepository跟StudentRepository類：

    public interface IStudentRepository
    {
        List<Student> List();

        Student Get(int id);

        bool Add(Student student);

        bool Update(Student student);

        bool Delete(int id);
    }

    public class StudentRepository : IStudentRepository
    {
        private static List<Student> Students = new List<Student> {
                new Student{ Id=1, Name="小紅", Age=10, Class="1班", Sex="女"},
                new Student{ Id=2, Name="小明", Age=11, Class="2班", Sex="男"},
                new Student{ Id=3, Name="小強", Age=12, Class="3班", Sex="男"}
        };

        public bool Add(Student student)
        {
            Students.Add(student);

            return true;
        }

        public bool Delete(int id)
        {
            var stu = Students.FirstOrDefault(s => s.Id == id);
            if (stu != null)
            {
                Students.Remove(stu);
            }

            return true;
        }

        public Student Get(int id)
        {
            return Students.FirstOrDefault(s=>s.Id == id);
        }

        public List<Student> List()
        {
            return Students;
        }

        public bool Update(Student student)
        {
            var stu = Students.FirstOrDefault(s=>s.Id == student.Id);
            if (stu != null)
            {
                Students.Remove(stu);
            }

            Students.Add(student);
            return true;
        }
    }

我們新建了一個IRepository介面，裡面有幾個基本的crud的方法。然後新建一個實現類，並且使用靜態變數保存數據，模擬數據持久化。
當然還得在DI容器中註冊一下：

  public void ConfigureServices(IServiceCollection services)
        {
            services.AddRazorPages();
            //註冊repository
            services.AddScoped<IStudentRepository, StudentRepository>();
        }

實現列表(student/list)頁面

列表頁面用來展現所有的學生信息。
修改ListModel類：

    public class ListModel : PageModel
    {
        private readonly IStudentRepository _studentRepository;
        public List<Student> Students { get; set; }
        public ListModel(IStudentRepository studentRepository) 
        {
            _studentRepository = studentRepository;
        }

        public void OnGet()
        {
            Students = _studentRepository.List();
        }
    }

修改List.cshtml模板：

@page
@model RazorPageCRUD.ListModel
@{
    ViewData["Title"] = "List";
}

<h1>List</h1>

<p>
    <a class="btn btn-primary" asp-page="Add">Add</a>
</p>
<table class="table">
    <tr>
        <th>Id</th>
        <th>Name</th>
        <th>Age</th>
        <th>Class</th>
        <th>Sex</th>
        <th></th>
    </tr>
    @foreach (var student in Model.Students)
    {
        <tr>
            <td>@student.Id</td>
            <td>@student.Name</td>
            <td>@student.Age</td>
            <td>@student.Class</td>
            <td>@student.Sex</td>
            <td>
                <a class="btn btn-primary" asp-page="Update" asp-route-id="@student.Id">Update</a>
                <a class="btn btn-danger" href="/student/[email protected]" >Delete</a>
            </td>
        </tr>
    }

</table>

ListModel類混合了MVC的Controller跟Model的概念。它本身可以認為是MVC裡面的那個Model，它包含的數據可以被razor試圖引擎使用，用來生成html，比如它的Students屬性；但是它又包含方法，可以用來處理業務邏輯，這個方法可以認為是Controller中的Action。方法通過特殊的首碼來跟前端的請求做綁定，比如OnGet方法就是對Get請求作出響應，OnPost則是對Post請求作出響應。
運行一下並且訪問/student/list：

列表頁面可以正常運行了。

使用asp-page進行頁面間導航

列表頁面上有幾個按鈕，比如新增、刪除等，點擊的時候希望跳轉至不同的頁面，可以使用asp-page屬性來實現。asp-page屬性不是html自帶的屬性，顯然這是Razor Pages為我們提供的。

<p>
    <a class="btn btn-primary" asp-page="Add">Add</a>
</p>

上面的代碼在a元素上添加了asp-page="Add"，表示點擊這個a連接會跳轉至同級目錄的Add頁面。html頁面之間的導航不管框架怎麼封裝無非就是url之間的跳轉。顯然這裡asp-page最後會翻譯成一個url，看看生成的頁面源碼：

<a class="btn btn-primary" href="/Student/Add">Add</a>

跟我們想的一樣，最後asp-page被翻譯成了href="/Student/Add"。

使用asp-route-xxx進行傳參

頁面間光導航還不夠，更多的時候我們還需要進行頁面間的傳參。比如我們的更新按鈕，需要跳轉至Update頁面並且傳遞一個id過去。

<a class="btn btn-primary" asp-page="Update" asp-route-id="@student.Id">Update</a>

我們使用asp-route-id來進行傳參。像這裡的a元素進行傳參，無非是放到url的querystring上。讓我們看一下生成的html源碼：

<a class="btn btn-primary" href="/Student/Update?id=2">Update</a>

不出所料最後id作為queryString被組裝到了url上。
上面演示了Razor Pages的導航跟傳參，使用了幾個框架內置的屬性，但其實我們根本可以不用這些東西就可以完成，使用標準的html方式來完成，比如刪除按鈕：

<a class="btn btn-danger" href="/student/[email protected]" >Delete</a>

上面的寫法完全可以工作，並且更加清晰明瞭，誰看了都知道是啥意思。
小小的吐槽下微軟：像asp-page這種封裝我是不太喜歡的，因為它掩蓋了html、http工作的本質原理。這樣會造成很多同學知道使用asp-page怎麼寫，但是換個框架就不知道怎麼搞了。我見過號稱精通asp.net的同學，但是對html、特別是對http一無所知。當你瞭解了真相後，甭管你用什麼技術，看起來其實都是一樣的，都是套路。

實現新增(student/add)頁面

新增頁面提供幾個輸入框輸入學生信息，並且可以提交到後臺。
修改AddModel類：

   public class AddModel : PageModel
   {
       private readonly IStudentRepository _studentRepository;
       public AddModel(IStudentRepository studentRepository)
       {
           _studentRepository = studentRepository;
       }
       public void OnGet()
       {
       }

       [BindProperty]
       public Student Student { get; set; }

       public IActionResult OnPostSave()
       {
           _studentRepository.Add(Student);
           return RedirectToPage("List");
       }
   }

修改Add.cshtml頁面

@page
@model RazorPageCRUD.AddModel
@{
    ViewData["Title"] = "Add";
}

<h1>Add</h1>

<form method="post">
    <div class="form-group">
        <label>Id</label>
        <input type="number" asp-for="Student.Id" class="form-control" />
    </div>
    <div class="form-group">
        <label>Name</label>
        <input type="text" asp-for="Student.Name" class="form-control" />
    </div>
    <div class="form-group">
        <label>Age</label>
        <input type="number" asp-for="Student.Age" class="form-control" />
    </div>
    <div class="form-group">
        <label>Class</label>
        <input type="text" asp-for="Student.Class" class="form-control" />
    </div>
    <div class="form-group">
        <label>Sex</label>
        <input type="text" asp-for="Student.Sex" class="form-control" />
    </div>
    <div class="form-group">
        <button type="submit" class="btn btn-primary" asp-page-handler="Save">Save</button>
        <a asp-page="list" class="btn btn-dark">Cancel</a>
    </div>
</form>

Add頁面使用一個form表單作為容器，裡面的文本框使用asp-for跟Model的Student屬性建立聯繫。
運行一下：

asp-for會把關聯的屬性欄位的值作為input元素的value的值，會把關聯的屬性名+欄位的名稱作為input元素的name屬性的值。看看生成的html源碼：

<input type="text" class="form-control" id="Student_Name" name="Student.Name" value="">

使用asp-page-handler來映射模型方法

我們的Save是一次POST提交，顯然我們需要一個後臺方法來接受這次請求並處理它。使用asp-page-handler="Save"可以跟模型的OnPostSave方法做映射。OnPost首碼表示對POST請求做響應，這又有點像webapi。那麼asp-page-handler為什麼能映射模型的方法呢？繼續看看生成的源碼：

<button type="submit" class="btn btn-primary" formaction="/Student/Add?handler=Save">Save</button>

看到這裡就明白了。最後生成的button上有個formaction屬性，值為/Student/Add?handler=Save。formaction相當於在form元素上指定action屬性的提交地址，並且在url上附帶了一個參數handler=save，這樣後臺就能查找具體要執行哪個方法了。不過據我的經驗formaction屬性存在瀏覽器相容問題。

使用BindPropertyAttribute進行參數綁定

光能映射後臺方法還不夠，我們還需要把前端的數據提交到後臺，並且拿到它。這裡可以使用BindPropertyAttribute來自動完成提交的表單數據跟模型屬性之間的映射。這樣我們的方法可以是無參的方法。


        [BindProperty]
        public Student Student { get; set; }

看到這裡突然有種MVVM模式的既視感了。雖然不是實時的雙向綁定，但是也實現了簡單的前後端綁定技術。另外提一句既然我們前端的數據是通過表單提交，那麼跟mvc一樣，使用FromFormAttribute其實一樣可以進行參數綁定的。

public IActionResult OnPostSave([FromForm] Stuend student)

這有獲取表單數據毫無問題。

在後臺方法進行頁面導航

當保存成功後需要使頁面跳轉到列表頁面，可以使用RedirectToPage等方法進行跳轉，OnPostSave方法的返回值類型也改成IActionResult，這就非常mvc了，跟action方法一模一樣的套路。

public IActionResult OnPostSave()
        {
            _studentRepository.Add(Student);
            return RedirectToPage("List");
        }

修改編輯(student/update)頁面

修改，刪除頁面就沒什麼好多講的了，使用前面的知識點輕鬆就能實現。
修改cshtml模板：

@page
@model RazorPageCRUD.UpdateModel
@{
    ViewData["Title"] = "Update";
}

<h1>Update</h1>

<form method="post">
    <div class="form-group">
        <label>Id</label>
        <input type="number" asp-for="Student.Id" class="form-control" />
    </div>
    <div class="form-group">
        <label>Name</label>
        <input type="text" asp-for="Student.Name" class="form-control" />
    </div>
    <div class="form-group">
        <label>Age</label>
        <input type="number" asp-for="Student.Age" class="form-control" />
    </div>
    <div class="form-group">
        <label>Class</label>
        <input type="text" asp-for="Student.Class" class="form-control" />
    </div>
    <div class="form-group">
        <label>Sex</label>
        <input type="text" asp-for="Student.Sex" class="form-control" />
    </div>
    <div class="form-group">
        <button type="submit" class="btn btn-primary" asp-page-handler="Edit">Save</button>
        <a asp-page="list" class="btn btn-dark">Cancel</a>
    </div>
</form>

修改UpdateModel類：

    public class UpdateModel : PageModel
    {
        private readonly IStudentRepository _studentRepository;
        public UpdateModel(IStudentRepository studentRepository)
        {
            _studentRepository = studentRepository;
        }
        public void OnGet(int id)
        {
            Student = _studentRepository.Get(id);
        }

        [BindProperty]
        public Student Student { get; set; }

        public IActionResult OnPostEdit()
        {
            _studentRepository.Update(Student);

            return RedirectToPage("List");
        }
    }

運行一下：

修改刪除(student/delete)頁面

刪除頁面跟前面一樣沒什麼好多講的了，使用前面的知識點輕鬆就能實現。
修改Delete.cshtml模板：

@page
@model RazorPageCRUD.DeleteModel
@{
    ViewData["Title"] = "Delete";
}

<h1>Delete</h1>
<h2 class="text-danger">
    確定刪除？
</h2>
<form method="post">
    <div class="form-group">
        Id: @Model.Student.Id
    </div>
    <div class="form-group">
        Name:@Model.Student.Name
    </div>
    <div class="form-group">
        Age: @Model.Student.Age
    </div>
    <div class="form-group">
        Class: @Model.Student.Class
    </div>
    <div class="form-group">
        Sex: @Model.Student.Sex
    </div>
    <div class="form-group">
        <button type="submit" class="btn btn-primary" asp-page-handler="Delete" asp-route-id="@Model.Student.Id">Delete</button>
        <a asp-page="list" class="btn btn-dark">Cancel</a>
    </div>
</form>

修改DeleteModel類：

     public class DeleteModel : PageModel
    {
        private readonly IStudentRepository _studentRepository;
        public DeleteModel(IStudentRepository studentRepository)
        {
            _studentRepository = studentRepository;
        }

        public void OnGet(int id)
        {
            Student = _studentRepository.Get(id);
        }

        public Student Student { get; set; }

        public IActionResult OnPostDelete(int id)
        {
            _studentRepository.Delete(id);

            return RedirectToPage("list");
        }
    }

運行一下：

總結

通過上的簡單示例，對Razor Pages有了大概的瞭解。Razor Pages本質上對MVC模式的簡化，後臺模型聚合了Controller跟Model的的概念。並且提供了一些內置html屬性實現綁定技術。有人說Razor Pages是WebForm的繼任者，我倒不覺得。個人覺得它更像是MVC/MVVM的一種混合。[BindProperty]有點像WPF里的依賴屬性，OnPostXXX方法就像是Command命令；又或者[BindProperty]像VUE的Data屬性上的欄位，OnPostXXX像Methods里的方法；又或者整個Model像極了angularjs的$scope，混合了數據跟方法。只是Razor Pages畢竟是服務端渲染，不能進行實時雙向綁定而已。最後，說實話通過簡單的體驗，Razor Pages開發模式跟MVC模式相比並未有什麼特殊的優點，不知道後續發展會如何。


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 【2020Python修煉記】python併發編程（六）補充—進程池和線程池
    1、進程池的作用 進程池來控制進程數目，比如httpd的進程模式，規定最小進程數和最大進程數 2、創建進程池的類Pool 如果指定numprocess為3，則進程池會從無到有創建三個進程，然後自始至終使用這三個進程去執行所有任務，不會開啟其他進程 Pool([numprocess [,initial ...
  • CentOS下寶塔如何部署Django項目？
    基礎環境 裝好寶塔服務 寶塔里裝好【Python項目管理器】 寶塔里裝好【Nginx】 把Django項目代碼發到伺服器 把代碼放到伺服器上有兩種方法： 方法一：伺服器上安裝Git，通過Git Clone代碼到伺服器上 方法二：通過寶塔的FTP工具把代碼上傳上去 註意： 在目錄: 下新建一個文件夾， ...
  • 分享幾個我最喜愛的 Laravel 輔助函數
    下麵是我整理的在平常會經常用到的一些不錯的輔助方法。文中方法大都基於 Laravel7 以及更早的版本。（如果遇到問題，請先檢查是否是版本相容問題） Str::limit() 我們的第一個輔助函數 獲取一個字元串並用一個設定的字元長度限制截斷它 。它有兩個必須參數：你想截斷的字元串，以及返回的被截斷 ...
  • 這個教程價值有點高，利用Python製作全自動化營銷軟體！
    前言 我看到有很多人在賣一款軟體，價格還有點小貴。我就想著能不能自己做一款分享給你們，現在我來講一講我這個demo的思路。 利用Python去控制咱們的手機，這樣的話全天24小時你可以解放你自己的雙手，功能的話可以根據自己的需求多樣化。 既然要控制手機，那麼咱們需要利用到一個工具 ADB ，這個東西 ...
  • 小哥哥你有98K嗎？利用Python製作一款多功能變聲器！
    前言 好吧，關於這句小哥哥你有98K嗎？出自別人口中經常說的玩笑話，我也略懂一些游戲嘛。不過不常玩，廢話不多說，開始咱們今天的教程，非常簡單！ 利用Python製作一款多功能變聲器！ 咱們首先登陸百度智能雲，為什麼要登陸呢？ 因為它給咱們準備好了API阿，直接調用就好了。 點擊產品 人工智慧 然後就 ...
  • 記錄一次網盤資源不給提取碼的經歷！另類編程思維，Python破之！
    言： 記錄一次網盤資源不給提取碼的經歷！另類編程思維，Python破之！可能這個標題的意思不是所有人都能夠理解，簡單說明一下，就是好不容易在網上找資源，然而那個分享網盤的朋友忘記給提取碼了...... 思路： 當我說到這裡的時候有人肯定在想，跑字典嗎這是要。NO！ 跟大家說說我的思路，既然作者有過一 ...
  • Java生鮮電商平臺-生鮮電商功能介紹以及文檔下載(小程式/APP)
    Java生鮮電商平臺-生鮮電商功能介紹以及文檔下載(小程式/APP) 說明：以下是公佈生鮮電商小程式或者APP的功能列表，方便需要的朋友拿去學習與研究. 生鮮電商B2B2C功能清單 功能描述 前端 會員 註冊登錄 註冊 註冊分買家註冊和賣家註冊； 註冊有三種方式：用戶名、手機號、郵箱； 買家只能購買 ...
  • C# 基礎知識系列-13 常見類庫（三）
    0. 前言 在《C 基礎知識系列 13 常見類庫（二）》中，我們介紹了一下DateTime和TimeSpan這兩個結構體的內容，也就是C 中日期時間的簡單操作。本篇將介紹Guid和Nullable這兩個內容。 1. Guid 結構 Guid(Globally Unique Identifier) 全 ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發（一）：使用.NET MAUI開發第一個安卓APP
    移動開發（一）：使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說，近來想嘗試開發一款安卓APP，考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP，畢竟是使用Visual Studio開發工具，使用起來也比較的順手，結合微軟官方的教程進行了安卓 ...
  • wpf ToggleButton選中效果和一個登錄界面
    前言 QuestPDF 是一個開源 .NET 庫，用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫，它徹底改變了我們生成 PDF 文檔的方 ...
  • 彈幕樹洞項目功能新增篇
    項目地址 項目後端地址： https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址： ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址： http://tree ...
  • 第27篇 sqlserver2022詳細安裝步驟
    話不多說，直接開乾 一.下載 1.官方鏈接下載： https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe，運行開始下載SQL server； 二. ...
  • .NET 開源高性能 MQTT 類庫
    前言 隨著物聯網（IoT）技術的迅猛發展，MQTT（消息隊列遙測傳輸）協議憑藉其輕量級和高效性，已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫，為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog文檔翻譯系列（六） - 可用的接收器、增強器、格式化輸出
    Serilog支持多種接收器用於日誌存儲，增強器用於添加屬性，LogContext管理動態屬性，支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項，適用於不同需求。 ...
  • 警惕 Visual Studio 屬性求值副作用導致邏輯不符合預期
    目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據，爬取信息時需要模擬瀏覽器行為，否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下： 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • [使用目前最新版]HybridCLR6.9.0+YooAsset2.2.4實現純C# Unity熱更新方案 (一)
    1.前言 什麼是熱更新 游戲或者軟體更新時，無需重新下載客戶端進行安裝，而是在應用程式啟動的情況下，在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR，Xlua，ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles，Addressable， ...
  • 在 ASP.NET Core Web API 中使用操作篩選器統一處理通用操作
    本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺，其實像阿裡雲，騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後，它會送 ...
  • 第28篇 如何.net中實現高效可靠數據同步api
    通過以下方式可以高效，並保證數據同步的可靠性 1.API設計 使用RESTful設計，確保API端點明確，並使用適當的HTTP方法（如POST用於創建，PUT用於更新）。 設計清晰的請求和響應模型，以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類