ASP.NET Core MVC 從入門到精通之路由

来源:https://www.cnblogs.com/hsiang/archive/2023/04/13/17308420.html
-Advertisement-
Play Games

隨著技術的發展，ASP.NET Core MVC也推出了好長時間，經過不斷的版本更新迭代，已經越來越完善，本系列文章主要講解ASP.NET Core MVC開發B/S系統過程中所涉及到的相關內容，適用於初學者，在校畢業生，或其他想從事ASP.NET Core MVC 系統開發的人員。 經過前幾篇文章... ...


隨著技術的發展，ASP.NET Core MVC也推出了好長時間，經過不斷的版本更新迭代，已經越來越完善，本系列文章主要講解ASP.NET Core MVC開發B/S系統過程中所涉及到的相關內容，適用於初學者，在校畢業生，或其他想從事ASP.NET Core MVC 系統開發的人員。 經過前幾篇文章的講解，初步瞭解ASP.NET Core MVC項目創建，啟動運行，以及ASP.NET Core MVC的命名約定，創建控制器，視圖，模型，接收參數，傳遞數據等內容，今天繼續講解ASP.NET Core MVC 路由等相關內容，僅供學習分享使用。

 

 

什麼是路由？

 

路由是一種機制，主要是用於檢查每一個用戶請求，將用戶請求映射到Action中，這一動作通過路由中間件來實現。ASP.NET Core MVC使用路由中間件來匹配傳入請求的URL並將它們映射到操作（Action方法）。

 

預設路由

 

在通過模板創建ASP.NET Core MVC中，預設會添加路由中間件，並提供一種預設的路由映射規則和約束。

MapControllerRoute 用於創建單個路由。 單個路由命名為 default 路由。 大多數具有控制器和視圖的應用都使用類似 default 路由的路由模板。如下所示：

 1 using Microsoft.AspNetCore.Server.Kestrel.Core;
 2 using System.Text.Encodings.Web;
 3 using System.Text.Unicode;
 4 
 5 var builder = WebApplication.CreateBuilder(args);
 6 
 7 // Add services to the container.
 8 builder.Services.AddControllersWithViews().AddJsonOptions(options =>
 9 {
10     options.JsonSerializerOptions.Encoder = JavaScriptEncoder.Create(UnicodeRanges.All);
11 });
12 
13 builder.Services.Configure<KestrelServerOptions>(options =>
14 {
15     options.AllowSynchronousIO = true;
16 });
17 
18 var app = builder.Build();
19 
20 // Configure the HTTP request pipeline.
21 if (!app.Environment.IsDevelopment())
22 {
23     app.UseExceptionHandler("/Home/Error");
24     // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
25     app.UseHsts();
26 }
27 
28 app.UseHttpsRedirection();
29 app.UseStaticFiles();
30 //1. 添加路由中間件EndpointRoutingMiddleware
31 app.UseRouting();
32 
33 app.UseAuthorization();
34 
35 //2.為控制器和Action添加一種路由映射規則，包括名稱，規則，約束等
36 app.MapControllerRoute(
37     name: "default",
38     pattern: "{controller=Home}/{action=Index}/{id?}");
39 
40 app.Run();

在上述代碼中，創建預設路由的關鍵代碼如下所示：

1 app.MapControllerRoute(
2     name: "default",
3     pattern: "{controller=Home}/{action=Index}/{id?}");

其中各個屬性說明：

  • name表示路由名稱，預設值為default。
  • pattern 為匹配模板，預設值為"{controller=Home}/{action=Index}/{id?}"。其中預設controller=Home，表示預設值為HomeController，action=Index，表示預設預設值為Index。id後面的?表示為可空類型，可以根據需要來填寫。

 

預設路由示例

 

  • 如：/ 表示controller和action都採用預設值，相當於/Home/Index。
  • 如：/Hello表示只指定了controller，action為預設預設值，相當於/Hello/Index。
  • 如：/Hello/Test/5 根據路由匹配規則，提取出controller=HelloController , action=Test , id =5 。如果剛好存在此controller和action，則匹配導航成功。

創建預設路由的簡便寫法，可通過以下代碼替代上面的app.MapControllerRoute，如下所示：

1 //創建預設傳統路由的簡便寫法
2 app.MapDefaultControllerRoute();

以上是傳統路由的示例。 之所以稱為傳統路由，是因為它為 URL 路徑建立了一個約定：

  • 第一個路徑段 {controller=Home} 映射到控制器名稱。
  • 第二段 {action=Index} 映射到操作名稱。
  • 第三段 {id?} 用於可選 id。 {id?} 中的 ? 使其成為可選。 id 用於映射到模型實體。

此傳統路由映射具有以下特點：

  • 僅基於控制器和操作名稱。
  • 不基於命名空間、源文件位置或方法參數。

使用預設路由進行傳統路由可以創建應用，而無需為每個操作提出新的 URL 模式，有助於簡化代碼。使 UI 更具可預測性。

 

多個路由

 

在實際應用中，可以設置多個路由，為某些特定的需求設置專有路由。設置多個路由，如下所示：

1 //2.為控制器和Action添加一種路由映射規則，包括名稱，規則，約束等
2 app.MapControllerRoute(
3     name: "blog",
4     pattern: "blog/{*article}",
5     defaults: new { controller = "Blog", action = "Article" });
6 
7 app.MapControllerRoute(
8     name: "default",
9     pattern: "{controller=Home}/{action=Index}/{id?}");

在上述代碼中，名稱為blog的路由，雖然採用的是傳統路由，但只用於特定操作。

在創建多個路由時，以下幾點需要註意：

  • blog 路由比 default 路由具有更高的匹配優先順序，因為它最先添加。
  • 路由名稱為路由指定邏輯名稱，使用命名路由可以簡化 URL 創建，在應用程式範圍內必須唯一。
  • 預設情況下，傳統路由依賴於順序。 一般情況下，具有區域的路由應放在路由表中靠前的位置，因為它們比沒有區域的路由更具體。也就是：特殊的在前面，通用的在後面。

 

不明確操作

 

如果同一個請求有兩個action都滿足路由終結點的匹配，那麼路由會進行如下處理：

  • 選擇最佳的候選項。
  • 引發異常。

如下代碼，在請求時，會兩個都滿足路由匹配規則：

 1 /// <summary>
 2 /// 請求需要編輯的學生信息
 3 /// </summary>
 4 /// <param name="id"></param>
 5 /// <returns></returns>
 6 public IActionResult Edit(int id)
 7 {
 8     var student = new Student()
 9     {
10         Id = 1,
11         Name = "公子小六",
12         Age = 21,
13         Sex = "男"
14     };
15     return View();
16 }
17 
18 /// <summary>
19 /// 編輯後保存學生信息
20 /// </summary>
21 /// <param name="id"></param>
22 /// <param name="student"></param>
23 /// <returns></returns>
24 public IActionResult Edit(int id, Student student)
25 {
26     //保存學生
27     return View();
28 }

那麼路由中間件就會跑出異常，如下所示：

 

 在這種情況下，要解析正確的路由，需要通過Http謂詞來區分，只有當請求為Post時，才會請求Edit(int id,Student student)；其他請求時【一般為Get】，匹配Edit(int id)。添加Http謂詞後的代碼如下：

 1 /// <summary>
 2 /// 請求需要編輯的學生信息
 3 /// </summary>
 4 /// <param name="id"></param>
 5 /// <returns></returns>
 6 public IActionResult Edit(int id)
 7 {
 8     var student = new Student()
 9     {
10         Id = 1,
11         Name = "公子小六",
12         Age = 21,
13         Sex = "男"
14     };
15     return View();
16 }
17 
18 /// <summary>
19 /// 編輯後保存學生信息
20 /// </summary>
21 /// <param name="id"></param>
22 /// <param name="student"></param>
23 /// <returns></returns>
24 [HttpPost]
25 public IActionResult Edit(int id, Student student)
26 {
27     //保存學生
28     return View();
29 }

 

屬性路由

 

屬性路由一般用於WebAPI，使用一組屬性將操作直接映射到路由模板，將應用功能建模為一組資源。屬性路由使用[Route(template)]標記於controller或action中，示例如下所示：

 1 public class TestController : Controller
 2 {
 3 
 4     [Route("Test1")]
 5     [Route("Test1/Index")]
 6     [Route("Test1/Index/{id?}")]
 7     public IActionResult Index(int id)
 8     {
 9         ViewBag.Id = id;
10         return View();
11     }
12 
13     public IActionResult Test()
14     {
15         return View();
16     }
17 }

運行程式，在瀏覽器中，輸入網址【https://localhost:7116/Test1/Index/10】，如下所示：

 

註意：屬性路由中，也可用標記：[Route("[controller]/[action]")]，效果可傳統路由一致。

屬性路由與傳統路由對比

經過以上示例，屬性路由與傳統路由，主要由以下幾點差異：

  •  屬性路由需要更多輸入才能指定路由，屬性路由自定義比較強，更能精準控制路由。
  • 傳統預設路由會更簡潔地處理路由。 
  • 屬性路由優先順序高於傳統路由。對於屬性路由，控制器和操作名稱在操作匹配中不起作用，除非使用標記替換。
  • 屬性路由支持定義多個訪問同一操作的路由，意味著每個路由屬性都與操作方法上的每個路由屬性相結合。
  • 屬性路由支持使用與傳統路由相同的內聯語法，來指定可選參數、預設值和約束。如：[HttpPost("product14/{id:int}")]

 

保留關鍵字

 

在ASP.NET Core MVC項目中，會有一些關鍵字，作為路由參數名稱，如下所示：

  • action
  • area
  • controller
  • handler
  • page

在 Razor 視圖或 Razor 頁面的上下文中保留以下關鍵字：

  • page
  • using
  • namespace
  • inject
  • section
  • inherits
  • model
  • addTagHelper
  • removeTagHelper

一個常見錯誤是使用 page 作為屬性路由的路由參數。 這樣做會導致與 URL 生成不一致和令人困惑的行為。錯誤示例如下所示：

1 public class TestController : Controller
2 {
3     [Route("/articles/{page}")]
4     public IActionResult ListArticles(int page)
5     {
6         return View(page);
7     }
8 }

 

Http謂詞和路由模板

 

在ASP.NET Core MVC項目中，具有以下幾種謂詞，用於區分不同的請求方式：

  • [HttpGet]
  • [HttpPost]
  • [HttpPut]
  • [HttpDelete]
  • [HttpHead]
  • [HttpPatch]

ASP.NET Core 具有以下路由模板：

  • 所有 HTTP 謂詞模板都是路由模板。
  • [Route]

 

混合路由：屬性路由與傳統路由

 

ASP.NET Core 應用可以混合使用傳統路由和屬性路由。 通常，對為瀏覽器提供 HTML 頁的控制器使用傳統路由，對為 API 提供服務 REST 的控制器使用屬性路由。

操作既支持傳統路由，也支持屬性路由。 通過在控制器或操作上放置路由可實現屬性路由。 不能通過傳統路由訪問定義屬性路由的操作，反之亦然。 控制器上的任何路由屬性都會使控制器中的所有操作使用屬性路由。

屬性路由和傳統路由使用相同的路由引擎。

以上就是ASP.NET Core MVC從入門到精通之路由的全部內容，旨在拋磚引玉，一起學習，共同進步。


作者：小六公子
出處：http://www.cnblogs.com/hsiang/
本文版權歸作者和博客園共有，寫文不易，支持原創，歡迎轉載【點贊】，轉載請保留此段聲明，且在文章頁面明顯位置給出原文連接，謝謝。
關註個人公眾號，定時同步更新技術及職場文章


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

-Advertisement-
Play Games
更多相關文章
  • Java：如何加密或解密PDF文檔？
    在工作中，我們會將重要的文檔進行加密，並且設置用戶的訪問許可權，其他外部人員均無法打開，只有獲取該許可權的用戶才有資格打開文檔。此外，限制用戶的使用許可權，極大程度上阻止了那些有意要篡改、拷貝其中內容的人，提高文檔的安全性。與此同時，文檔加密的另一大作用是為了防止丟失，因為可能存在員工出差或離職時，將文檔 ...
  • 【驗證碼逆向專欄】某驗深知 V2 業務風控逆向分析
    聲明 本文章中所有內容僅供學習交流使用，不用於其他任何目的，不提供完整代碼，抓包內容、敏感網址、數據介面等均已做脫敏處理，嚴禁用於商業用途和非法用途，否則由此產生的一切後果均與作者無關！ 本文章未經許可禁止轉載，禁止任何修改後二次傳播，擅自使用本文講解的技術而導致的任何意外，作者均不負責，若有侵權， ...
  • 在Django+Vue3+GraphQL的Blog例子代碼中引入Element-Plus UI Framework
    Vue3的UI Framework中有Element-Plus、BalmUI、Quasar、PrimeVue、Ant Design Vue等UI Framework. Element-Plus是Element-UI的Vue3版,Element-UI的使用人數的基數較大,Github上的Star數也較 ...
  • 【0基礎學爬蟲】爬蟲基礎之數據存儲
    大數據時代，各行各業對數據採集的需求日益增多，網路爬蟲的運用也更為廣泛，越來越多的人開始學習網路爬蟲這項技術，K哥爬蟲此前已經推出不少爬蟲進階、逆向相關文章，為實現從易到難全方位覆蓋，特設【0基礎學爬蟲】專欄，幫助小白快速入門爬蟲，本期為數據存儲。 概述 上期我們介紹到了文件存儲，講到瞭如何將數據存 ...
  • 12函數進階
    函數進階 函數的作用域 作用域又可以被稱為命名空間，指變數起作用的範圍。Python變數作用域可以分為四種，分別為局部作用域、嵌套作用域、全局作用域、內置作用域。 | 作用域 | 英文 | | | | | 局部作用域 | Local | | 嵌套作用域 | Enclosing | | 全局作用域 | ...
  • #if、 #ifdef、#else、#endif等巨集詳解
    一、事件背景： 某天凌晨，一陣急促的鈴聲將我從周公那裡拉了過來，接聽電話後，一臉懵逼。 什麼情況？XX後臺宕機了？當日日誌也不列印了，前端發起的請求，都報超時，重啟後又恢復了，不清楚會不會再次宕機。 出現這種情況，我第一時間想的是為什麼是00:00:00宕機？難道後臺嫌我這個大齡程式員睡得早了？ 然 ...
  • 如何實現 Java SpringBoot 自動驗證入參數據的有效性
    Java SpringBoot 通過javax.validation.constraints下的註解，實現入參數據自動驗證 如果碰到 `@NotEmpty` 否則不生效，註意看下 `@RequestBody` 前面是否加上了`@Valid` ...
  • Go語言入門7（interface 介面）
    介面 ​ 介面類型是對其它類型行為的抽象和概括，因為介面類型不會和特定的實現細節綁定在一 起，通過這種抽象的方式我們可以讓我們的函數更加靈活和更具有適應能力 介面的特點 可以包含0個或多個方法的簽名 只定義方法的簽名，不包含實現 實現介面不需要顯式的聲明，只需實現相應方法即可 介面實現 ​ 介面里沒 ...
一周排行
    -Advertisement-
    Play Games
  • C# + WPF 音頻播放器 界面優雅，體驗良好
    前言 本文介紹一款使用 C# 與 WPF 開發的音頻播放器，其界面簡潔大方，操作體驗流暢。該播放器支持多種音頻格式（如 MP4、WMA、OGG、FLAC 等），並具備標記、實時歌詞顯示等功能。 另外，還支持換膚及多語言（中英文）切換。核心音頻處理採用 FFmpeg 組件，獲得了廣泛認可，目前 Git ...
  • OAuth2.0授權-gitee授權碼模式
    OAuth2.0授權驗證-gitee授權碼模式 本文主要介紹如何筆者自己是如何使用gitee提供的OAuth2.0協議完成授權驗證並登錄到自己的系統，完整模式如圖 1、創建應用 打開gitee個人中心->第三方應用->創建應用 創建應用後在我的應用界面，查看已創建應用的Client ID和Clien ...
  • FastReport.OpenSource .Net下開源免費報表列印組件
    解決了這個問題：《winForm下，fastReport.net 從.net framework 升級到.net5遇到的錯誤“Operation is not supported on this platform.”》 本文內容轉載自：https://www.fcnsoft.com/Home/Sho ...
  • 如何在 ASP.NET Core Web API 方法執行前後 “偷偷“ 作一些 “壞“ 事？初識 ActionFilterAttribute
    國內文章 WPF 從裸 Win 32 的 WM_Pointer 消息獲取觸摸點繪製筆跡 https://www.cnblogs.com/lindexi/p/18390983 本文將告訴大家如何在 WPF 裡面，接收裸 Win 32 的 WM_Pointer 消息，從消息裡面獲取觸摸點信息，使用觸摸點 ...
  • 在 ASP.NET Core Web API 中使用異常篩選器捕獲和統一處理異常
    前言 給大家推薦一個專為新零售快消行業打造了一套高效的進銷存管理系統。 系統不僅具備強大的庫存管理功能，還集成了高性能的輕量級 POS 解決方案，確保頁面載入速度極快，提供良好的用戶體驗。 項目介紹 Dorisoy.POS 是一款基於 .NET 7 和 Angular 4 開發的新零售快消進銷存管理 ...
  • AbpHelper CLI積累與實戰分享
    ABP CLI常用的代碼分享 一、確保環境配置正確 安裝.NET CLI： ABP CLI是基於.NET Core或.NET 5/6/7等更高版本構建的，因此首先需要在你的開發環境中安裝.NET CLI。這可以通過訪問Microsoft官網下載並安裝相應版本的.NET SDK來實現。 安裝ABP ...
  • 記一次HttpClient使用問題分析
    問題 問題是這樣的：第三方的webapi，需要先調用登陸介面獲取Cookie，訪問其它介面時攜帶Cookie信息。 但使用HttpClient類調用登陸介面，返回的Headers中沒有找到Cookie信息。 分析 首先，使用Postman測試該登陸介面，正常返回Cookie信息，說明是HttpCli ...
  • .NET周刊【9月第3期 2024-09-15】
    國內文章 關於.NET在中國為什麼工資低的分析 https://www.cnblogs.com/thinkingmore/p/18406244 .NET在中國開發者的薪資偏低，主要因市場需求、技術棧選擇和企業文化等因素所致。歷史上，.NET曾因微軟的閉源策略發展受限，儘管後來推出了跨平臺的.NET ...
  • 我的網站集成ElasticSearch初體驗
    在WPF開發應用中，動畫不僅可以引起用戶的註意與興趣，而且還使軟體更加便於使用。前面幾篇文章講解了畫筆（Brush），形狀（Shape），幾何圖形（Geometry），變換（Transform）等相關內容，今天繼續講解動畫相關內容和知識點，僅供學習分享使用，如有不足之處，還請指正。 ...
  • 第23篇 委托的概述
    什麼是委托？ 委托可以說是把一個方法代入另一個方法執行，相當於指向函數的指針；事件就相當於保存委托的數組； 1.實例化委托的方式： 方式1：通過new創建實例： public delegate void ShowDelegate(); 或者 public delegate string ShowDe ...
所有分類