解讀ASP.NET 5 & MVC6系列教程(14):View Component
在之前的MVC中,我們經(jīng)常需要類似一種小部件的功能,通常我們都是使用Partial View來實現(xiàn),因為MVC中沒有類似Web Forms中的WebControl的功能。但在MVC6中,這一功能得到了極大的改善。新版MVC6中,提供了一種叫做View Component的功能。
你可以將View Component看做是一個mini的Controller——它只負責渲染一小部分內(nèi)容,而非全部響應,所有Partial View能解決的問題,你都可以使用View Component來解決,比如:動態(tài)導航菜單、Tag標簽、登錄窗口、購物車、最近閱讀文章等等。
View Component包含2個部分,一部分是類(繼承于ViewComponent),另外一個是Razor視圖(和普通的View視圖一樣)。就像新版MVC中的Controller一樣,ViewComponent也可以使POCO的(即不繼承ViewComponent類,但類名以ViewComponent結(jié)尾)。
View Component的創(chuàng)建
目前,View Component類的創(chuàng)建方式有如下三種:
直接繼承于ViewComponent給類加上ViewComponent特性,或繼承于帶有ViewComponent特性的類創(chuàng)建一個類,類名以ViewComponent結(jié)尾
和Controller一樣,View Component必須是public的,不能嵌套,不能是抽象類。
舉例來說,我們創(chuàng)建一個View Component,類名為TopListViewComponent,代碼如下:
public class TopListViewComponent : ViewComponent { private readonly ApplicationDbContext db; public TopListViewComponent(ApplicationDbContext context) { db = context; } public IViewComponentResult Invoke(int categoryId, int topN) { List<string> col = new List<string>(); var items = db.TodoItems.Where(x => x.IsDone == false && x.categoryId == categoryId).Take(topN); return View(items); } }
上述類,也可以定義成如下這樣:
[ViewComponent(Name = "TopList")] public class TopWidget { // 其它類似 }
通過在TopWidget類上定義一個名稱為TopList的ViewComponent特性,其效果和定義TopListViewComponent類一樣,系統(tǒng)在查找的時候,都會認可,并且在其構(gòu)造函數(shù)中通過依賴注入功能提示構(gòu)造函數(shù)中參數(shù)的類型實例。
Invoke方法是一個約定方法,可以傳入任意數(shù)量的參數(shù),系統(tǒng)也支持InvokeAsync方法實現(xiàn)異步功能。
View Component的視圖文件創(chuàng)建
以在ProductController
的視圖里調(diào)用View Component為例,我們需要在Views\Product
文件夾下創(chuàng)建一個名稱為Components
的文件夾(該文件夾名稱必須為Components
)。
然后在Views\Product\Components
文件夾下創(chuàng)建一個名稱為TopList
的文件夾(該文件夾名稱必須和View Component名稱一致,即必須是TopList
)。
在Views\Product\Components\TopList
文件夾下,創(chuàng)建一個Default.cshtml
視圖文件,并添加如下標記:
@model IEnumerable<BookStore.Models.ProductItem> <h3>Top Products</h3> <ul> @foreach (var todo in Model) { <li>@todo.Title</li> } </ul>
如果再View Component中,沒有指定視圖的名稱,將默認為Default.cshtml
視圖。
至此,該View Component就創(chuàng)建好了,你可以在Views\Product\index.cshtml視圖中的任意位置調(diào)用該View Component,比如:
<div class="col-md-4"> @Component.Invoke("TopList", 1, 10) </div>
如果在上述TopListViewComponent中定義的是異步方法InvokeAsync的話,則可以使用@await Component.InvokeAsync()
方法來調(diào)用,這兩個方法的第一個參數(shù)都是TopListViewComponent的名稱,剩余的參數(shù)則是在TopListViewComponent類中定義的方法參數(shù)。
注意:一般來說,View Component的視圖文件都是添加在Views\Shared文件夾的,因為一般來說ViewComponent不會特定于某個Controller。
使用自定義視圖文件
一般來說,如果要使用自定義文件,我們需要在Invoke的方法返回返回值的時候來指定視圖的名稱,示例如下:
return View("TopN", items);
那么,就需要創(chuàng)建一個Views\Product\Components\TopN.cshtml
文件,而使用的時候則無需更改,還是指定原來的View Component名稱即可,比如:
@await Component.InvokeAsync("TopList", 1, 10) //以異步調(diào)用為例
總結(jié)
一般來說,建議在通用的功能上使用View Component的功能,這樣所有的視圖文件都可以放在Views\Shared
文件夾了。
相關(guān)文章
解讀ASP.NET 5 & MVC6系列教程(2):初識項目
這篇文章主要介紹ASP.NET 5中新建項目的結(jié)構(gòu)和之前的差異,介紹的比較細致,需要的朋友可以參考下。2016-06-06解讀ASP.NET 5 & MVC6系列教程(14):View Component
這篇文章主要介紹了ASP.NET 5 MVC6 中View Component創(chuàng)建和視圖的使用,需要的朋友可以參考下2016-06-06在ASP.NET 2.0中操作數(shù)據(jù)之三十四:基于DataList和Repeater跨頁面的主/從報表
前面介紹了使用GridView實現(xiàn)跨頁面的主/從報表,同樣DataList和Repeater也可以實現(xiàn)相同功能。2016-05-05NopCommerce架構(gòu)分析之(七)主題Theme皮膚管理器
本文主要介紹NopCommerce的皮膚管理機制,NopCommerce提供默認的皮膚,我們也可以制作自己的皮膚,以實現(xiàn)個性化定制。2016-04-04在ASP.NET 2.0中操作數(shù)據(jù)之三十九:在DataList的編輯界面里添加驗證控件
為了防止用戶非法的輸入,這節(jié)主要介紹如何在編輯數(shù)據(jù)的時候添加驗證控件,以避免出現(xiàn)異常和保證數(shù)據(jù)的完整性。2016-05-05在ASP.NET 2.0中操作數(shù)據(jù)之二十一:實現(xiàn)開放式并發(fā)
本文主要介紹ASP.NET 2.0如何實現(xiàn)開放式并發(fā)控制,并逐步講解從數(shù)據(jù)訪問層到業(yè)務邏輯層以及到最終的頁面是如何一步一步操作的。2016-05-05使用.Net6中的WebApplication打造最小API
本文詳細講解了使用.Net6中的WebApplication打造最小API,文中通過示例代碼介紹的非常詳細。對大家的學習或工作具有一定的參考借鑒價值,需要的朋友可以參考下2021-12-12Mac中體驗ASP.NET 5 beta2的K gen代碼生成
這篇文章主要介紹了Mac中體驗ASP.NET 5 beta2的K gen代碼生成,需要的朋友可以參考一下。2016-06-06