目录
- 第 6 天
- 第 7 天
0. 前言
欢迎来到第五天的学习。希望第一天到第四天的学习,你都是开心的。
1. Lab 22 — 增加 Footer
在这个实验中,我们将会向 Employee 页面添加 Footer。本次实验的目标是理解分部视图(Partial Views)。
什么是「Partial Views」?
逻辑上讲,分部视图(Partial Views) 是一个可重用的视图,它不会被直接显示。它会被其它视图所包含,然后作为该视图的一部分来显示。它类似于 ASP.NET Web Forms 中的用户控件,但是没有后台代码。
第一步:为 Partial View 创建 ViewModel
右击 ViewModel 文件夹,然后创建一个类,命名为 FooterViewModel。
public class FooterViewModel{ public string CompanyName { get; set; } public string Year { get; set; }}
第二步:创建 Partial View
右击「~/Views/Shared」文件夹,选择 Add -> View。
设置视图的名称为 Footer。选中「Create as a partial view」复选框,然后点击「Add」。
注意:我们已经在第一天的学习中谈论了 Shared 文件夹。Shared 文件夹包含了视图,这些视图不会属于一个特定的控制器。在 Shared 文件夹下的视图适用于所有控制器。
第三步:在 Partial View 中显示数据
打开 Footer.cshtml,然后放置如下代码。
@using WebApplication1.ViewModels@model FooterViewModel@Model.CompanyName © @Model.Year
第四步:在 Main ViewModel 中包含 Footer 数据
打开 EmployeeListViewModel 类,然后增加一个新的属性来承载 Footer 数据。
public class EmployeeListViewModel{ public ListEmployees { get; set; } public string UserName { get; set; } public FooterViewModel FooterData { get; set; }//New Property}
在我们的例子中,Footer 视图将会作为 Index 视图的一部分展示。
我们将会在 Index 视图中向 Footer 传输必要数据。
Index 视图是一个 EmployeeListViewModel 的强类型视图,因此 Footer 中需要的数据都应该被封装在 EmployeeListViewModel 类中。
第五步:设置 Footer 数据
打开 EmployeeController,然后在 Index 行为方法中设定 FooterData 属性值。
public ActionResult Index(){ ... ... employeeListViewModel.FooterData = new FooterViewModel(); employeeListViewModel.FooterData.CompanyName = "StepByStepSchools";//Can be set to dynamic value employeeListViewModel.FooterData.Year = DateTime.Now.Year.ToString(); return View("Index", employeeListViewModel);}
第六步:展示 Footer
打开 Index.cshtml 文件,然后在 Table 标签后展示 Footer 视图。
@{ Html.RenderPartial("Footer", Model.FooterData); }
第七步:执行并测试
按下 F5。导航到 Index 视图。
Lab 22 的 Q&A
Html.Partial 是用来做什么的?
它类似于 Html.RenderPartial,Html.Partial 用于在视图中展示 Partial View。
它的语法如下。非常简单。
@Html.Partial("Footer", Model.FooterData);
两者的区别是什么?
Html.RenderPartial 将会把 Partial View 的结果写入 HTTP 响应流中,而 Html.Partial 将会以 MvcHtmlString 的格式返回结果。
什么是 MvcHtmlString,为什么 Html.Partial 返回的是 MvcHtmlString,而不是字符串?
首先让我们理解下什么是 MvcHtmlString。
MSDN 的定义是「MvcHtmlString 代表一个 HTML 编码的字符串,这种字符串不应该再次编码」。
更好地理解这个定义,请查看下面代码。
@{ string MyString = "My Simple String";}@MyString
它将会产生如下输出。
正如你所看见的,Razor 展示了所有的内容。可能许多人会以为将输出加粗的字符串,但是 Razor Html 在展示之前对内容进行了编码,这就是为什么我们获得的是纯内容,而不是加粗的字符串。
当我们不想用 Razor 编码时,我们可以使用 MvcHtmlString。MvcHtmlString 是 Razor 的一种表示,即「字符串已经编码了,不再需要额外编码」。
例如我们可以看下面的代码。
@{ string MyString = "My Simple String";}@MvcHtmlString.Create(MyString)
它将会产生如下输出。
为什么 Html.Partial 返回的是 MvcHtmlString,而不是字符串呢?
我们已经理解了「Razor 将会编码字符串,但是不会对 MvcHtmlString 编码」这一事实。如果 Partial View 内容被认为是像它展示的那样的纯字符串,便没有意义。我们希望它被当成是一个 HTML 内容,这样我们就需要停止 Razor 编码,因此 Partial 方法被设计为返回 MvcHtmlString。
哪个更加推崇,Html.RenderPartial 还是 Html.Partial ?
Html.RenderPartial 更被推崇,因为它更快。
什么时候运用 Html.Partial 更好?
当我们想在展示之前改变 Partial View 返回的结果,推荐使用 Html.Partial。
打开 Index.cshtml,然后打开 Footer,放置如下代码。
@{ MvcHtmlString result = Html.Partial ("Footer", Model.FooterData); string finalResult = result.ToHtmlString().Replace("2015", "20000"); }@MvcHtmlString.Create(finalResult)
现在页脚展示如下。
为什么将 Partial View 放置在 Shared 文件夹下?
因为 Partial View 意味着可以重复利用的资源,因此放置它们的地点是 Shared 文件夹下。
我们不能将 Partial View 放置到一个特殊的控制器文件夹内吗?例如 Employee 或者 Authentication?
我们可以这样做,但是在这种场景下,它将不会适用于指定控制器。
例如:当我们将 Partial View 放置到 Employee 文件夹下,它将不会适用于 AuthenticationController 或者适用于 AuthenticationController 相关的视图。
为什么 Partial View 的定义包含「逻辑」词汇?
在定义中,我们已经知道 Partial View 是一个可重用的视图,但是它不能通过自己执行。它需要放置到其它视图中,然后作为这些视图的一部分来展示。
我们所说的 Partial View 可重用是事实,但是我们提到的执行在逻辑上是事实。技术上而言,这不是一个正确的解释。我们可以创建一个行为方法,来返回如下的视图结果。
public ActionResult MyFooter(){ FooterViewModel FooterData = new FooterViewModel(); FooterData.CompanyName = "StepByStepSchools";//Can be set to dynamic value FooterData.Year = DateTime.Now.Year.ToString(); return View("Footer", FooterData);}
它将会展示如下的输出。
尽管在逻辑上没有意义,但是技术上是可行的。Footer.cshtml 不会包含正确的结构性 HTML。它意味着作为视图的一部分来展示。因为我们说「逻辑上是没有意义的」。
为什么要创建 Partial View,而不是直接在视图底部添加内容?
这样做有两个优势。
-
可重用性。我们可以将一个 Partial View 运用到多个视图中去。
-
代码保留。将其放置为一个分割的文件,使其管理和操纵都非常方便。
为什么在 Partial View 中没有创建 Header?
作为最佳实践,我们需要为 Partial View 创建 Header,但是为了保持最初实验简单化,我们并没有这样做。
2. Lab 23 — 实现基于角色的安全性
在本次实验中,我们将会实现 Admin 和 Non-Admin 两种登录功能。
需求是很简单的。即「Non-Admin 用户不能创建 Employees」。
通过这个实验,我们将会理解 MVC 中的两个主题。
-
Session
-
Action Filters
现在我们开始进行实验。为了简单化,我们将实验分为两部分。
Part 1 — Non-Admin 用户登录,隐藏 AddNew 链接
第一步:创建标识 UserStatus 的枚举
右击 Models 文件夹,选择「Add New Item」。
在对话框中选择「Code File」选项。
在名称栏中输入「UserStatus」,然后点击添加。「Code File」的选项将会创建一个空白的「.cs」文件。
创建一个枚举,命名为 UserStatus,代码如下。
namespace WebApplication1.Models{ public enum UserStatus { AuthenticatedAdmin, AuthentucatedUser, NonAuthenticatedUser }}
第二步:更改业务层功能
删除 IsValidUser 功能,然后创建一个新的功能,命名为 GetUserValidity。
public UserStatus GetUserValidity(UserDetails u){ if (u.UserName == "Admin" && u.Password == "Admin") { return UserStatus.AuthenticatedAdmin; } else if (u.UserName == "Sukesh" && u.Password == "Sukesh") { return UserStatus.AuthentucatedUser; } else { return UserStatus.NonAuthenticatedUser; }}
第三步:更改 DoLogin 行为方法
打开 AuthenticationController,然后更改 DoLogin 行为方法如下。
[HttpPost]public ActionResult DoLogin(UserDetails u){ if (ModelState.IsValid) { EmployeeBusinessLayer bal = new EmployeeBusinessLayer(); //New Code Start UserStatus status = bal.GetUserValidity(u); bool IsAdmin = false; if (status==UserStatus.AuthenticatedAdmin) { IsAdmin = true; } else if (status == UserStatus.AuthentucatedUser) { IsAdmin = false; } else { ModelState.AddModelError("CredentialError", "Invalid Username or Password"); return View("Login"); } FormsAuthentication.SetAuthCookie(u.UserName, false); Session["IsAdmin"] = IsAdmin; return RedirectToAction("Index", "Employee"); //New Code End } else { return View("Login"); }}
正如你所看见的,我们运用 Session 变量来识别用户是 Admin 用户还是 non-Admin 用户。
不知道什么是 Session?
Session 是 ASP.NET 的一个功能,在 ASP.NET MVC 中被重用。
我们运用 Session 变量来承载用户相关的数据。Session 的生命周期取决于用户的生命周期。它将一直可用直到当前的 Session 结束。
第四步:删除已经存在的 AddNew 链接
在「~/Views/Employee」文件夹下打开 Index.cshtml 视图,然后完全删除「Add New」超链接。
Add New
第五步:创建 Partial View
右击「~/Views/Employee」文件夹,然后选择 Add -> View。设置视图的名称为「AddNewLink」,然后确保选择「Create as a partial view」复选框。
第六步:在 Partial View 中放置内容
在刚创建的 Partial View 中放置如下内容。
Add New
第七步:创建行为方法
打开 EmployeeController 然后创建一个新的行为方法,命名为「GetAddNewLink」。
public ActionResult GetAddNewLink(){ if (Convert.ToBoolean(Session["IsAdmin"])) { return Partial View("AddNewLink"); } else { return new EmptyResult(); }}
第八步:展示 AddNew 链接
打开 Index.html,然后放置如下代码。
Logout
@{ Html.RenderAction("GetAddNewLink");}
Html.RenderAction 执行行为方法,然后向响应流中直接写入结果。
第九步:执行并测试
按下 F5,然后执行应用。
- Test 1
- Test 2
Part 2 — 直接的 URL 安全性
按照上述的逻辑,一件事是可以确保的。即现在 non-Admin 用户不能通过超链接导航到 AddNew 行为。
这样就够了吗?
答案是否定的,这还不够。如果一个 non-Admin 用户直接通过 URL 试图导航到 AddNew 行为会发生什么呢。
正如你在上述例子中所看见的,一个 non-Admin 用户依然可以访问 AddNew 行为。
为了解决这个问题,我们需要运用 MVC 中的 Action Filters。Action Filters 让我们向行为方法中添加一些预处理和后处理的逻辑。在本实验中,我们将着重于 Action Filters 的预处理功能,在后面的实验中,我们再着重于后处理功能。
第一步:设置过滤器
在项目下创建一个新的文件夹,命名为 Filters,然后创建一个新的类,命名为 AdminFilter。
第二步:创建过滤器
升级简单的 AdminFilter 类到 ActionFilter,通过将其继承 ActionFilterAttribute 类,代码如下。
public class AdminFilter:ActionFilterAttribute{}
注:为了运用 ActionFilterAttribute,你需要在顶部引用 System.Web.Mvc。
第三步:增加安全认证逻辑
在 ActionFilter 中重写 OnActionExecuting 方法。
public override void OnActionExecuting(ActionExecutingContext filterContext){ if (!Convert.ToBoolean(filterContext.HttpContext.Session["IsAdmin"])) { filterContext.Result = new ContentResult() { Content="Unauthorized to access specified resource." }; }}
第四步:附加过滤器
向 AddNew 和 SaveEmployee 行为方法添加过滤器。
[AdminFilter]public ActionResult AddNew(){ return View("CreateEmployee",new Employee());}......[AdminFilter]public ActionResult SaveEmployee(Employee e, string BtnSubmit){ switch (BtnSubmit) { case "Save Employee": if (ModelState.IsValid) { EmployeeBusinessLayer empBal = new EmployeeBusinessLayer();........
第五步:执行和测试
按下 F5,然后执行应用。运用 non-Admin 身份登录,然后试图通过 AddNew 行为的 URL 导航到 AddNew 行为方法。
正如你所看见的,现在你的行为方法处于完全安全状态。
Lab 23 的 Q&A
我们可以通过地址栏直接触发 GetAddNewLink 吗?
答案是肯定的,我们已经在「Talk on Lab 22」部分讨论了这个行为。
直接停止执行 GetAddNewLink 有可能吗?
可以直接在 GetAddNewLink 中添加 ChildActionOnly 属性。
[ChildActionOnly]public ActionResult GetAddNewLink(){ if (Convert.ToBoolean(Session["IsAdmin"])){
Html.Action 是用来做什么的?
就类似于 Html.RenderAction,Html.Action 将会执行行为方法用于呈现视图的结果。下面是语法。
@Html.Action("GetAddNewLink");
可以看出,语法相对来说简单多了。
两者的区别是什么?
Html.RenderAction 将会把行为方法的执行结果直接写入 HTTP 响应流,而 Html.Action 将会返回 MvcHtmlString 结果。
哪个更推崇?是 Html.RenderAction 还是 Html.Action?
更推崇 Html.RenderAction,因为它更快。
什么时候用 Html.Action 更好?
当我们想在呈现之前改变行为方法执行的结果时,用 Html.Action 更好。
什么是 ActionFilter?
就类似于 AuthenticationFilter,ActionFilter 是 ASP.NET MVC 的一种过滤器类型。它允许我们向行为方法添加预处理和后处理逻辑。
3. Lab 24 — 任务实验 — 处理 CSRF 攻击
从视图的安全性方面出发,我们还需要在项目中处理 CSRF 攻击。这里我将不再做过多指导,你需要自己手动完成。
我建议你阅读下述文章,然后实现方法。
4. Lab 25 — 实现项目的一致性外观
在 ASP.NET 领域中,一致性的布局意味着母版页(MasterPage)。
但 ASP.NET MVC 是区别于此的。在 Razor 中,母版页被称为布局页(Layout Pages)。
在正式开始试验之前,我们先来讨论一下在母版页中我们需要放置哪些元素。
1.带有欢迎信息的 Header。 2.带有页脚数据的 Footer。
最大的问题是什么?
页脚和页眉的数据作为 ViewModel 的一部分从控制器传输到视图中。
现在最大的问题便是,当页眉和页脚移动到布局页后,数据如何从视图传输到布局页。
解决方案 — 继承
在这里我们可以简单地遵循面向对象继承准则。让我们通过一个小实验来理解。
第一步:创建 ViewModel 的基类
在 ViewModel 文件夹下创建一个新的 ViewModel 类,称为 BaseViewModel 类。
public class BaseViewModel{ public string UserName { get; set; } public FooterViewModel FooterData { get; set; }//New Property}
正如你所看见的,BaseViewModel 封装了 Layout 页所需的所有元素。
第二步:准备 EmployeeListViewModel
从 EmployeeListViewModel 类中移除 UserName 和 FooterData 属性,然后让它继承 BaseViewModel 类。
public class EmployeeListViewModel:BaseViewModel{ public ListEmployees { get; set; }}
第三步:创建布局页
右击 Shared 文件夹,选择 Add -> MVC 5 Layout Page。输入名称为 MyLayout,然后点击确定。
它将会创建一个如下格式的代码。
@ViewBag.Title @RenderBody()
第四步:转换布局页为强类型布局
在布局页的上方放置如下的简单声明,使其变为强类型布局。
@using WebApplication1.ViewModels@model BaseViewModel
第五步:设计布局页
在布局页添加页眉,页脚和内容三部分。
@RenderSection("TitleSection") @RenderSection("HeaderSection",false)Hello, @Model.UserName Logout
@RenderSection("ContentBody")@Html.Partial("Footer",Model.FooterData)
正如你所看见的,我们已经为布局页创建了三块。Title 部分,Header 部分和Content 部分。内容页面将会用到这三部分来定义合适的内容。
第六步:向 Index 视图附上 Layout 页面
打开 Index.cshtml 页面,在顶部会发现如下代码。
@{ Layout = null;}
将这段代码改为如下代码。
@{ Layout = "~/Views/Shared/MyLayout.cshtml";}
第七步:设计 Index 视图
- 从 Index 视图中移除 Headers 和 Footers。
- 复制 Body 标签中的剩余内容,然后将它保存在别处。
- 复制 Title 标签里的内容。
- 将视图中的所有 HTML 内容都移除。确保你只是移除了 HTML,@model 和布局声明不需要被移除。
- 定义 Title 部分和 Content 部分,内容是刚才所复制下的内容。
完整的视图将会如下所示。
@using WebApplication1.ViewModels@model EmployeeListViewModel@{ Layout = "~/Views/Shared/MyLayout.cshtml";}@section TitleSection{ MyView}@section ContentBody{@{ Html.RenderAction("GetAddNewLink"); }}
@foreach (EmployeeViewModel item in Model.Employees) { Employee Name Salary } @item.EmployeeName @item.Salary
正如你所看见的,视图中所有的元素都定义在指定的位置上。
第八步:执行并测试
按下 F5,然后执行应用。导航到 Index 行为上。
第九步:在 CreateEmployee 视图中附上 Layout 页面
打开 Index.cshtml 页面,在顶部会发现如下代码。
@{ Layout = null;}
将其改为如下代码。
@{ Layout = "~/Views/Shared/MyLayout.cshtml";}
第十步:设计 CreateEmployee 视图
像第七步的步骤一样,定义 CreateEmployee 视图的区域。这一次会增加一点。我们将会定义 Header 部分。
完整的 HTML 代码如下。
@using WebApplication1.Models@model Employee@{ Layout = "~/Views/Shared/MyLayout.cshtml";}@section TitleSection{ CreateEmployee}@section HeaderSection{}@section ContentBody{}
第十一步:执行并测试
按下 F5,然后执行应用。通过尝试超链接来导航到 AddNew 行为上。
Index 视图是 EmployeeListViewModel 的强类型视图,EmployeeListViewModel 又是 BaseViewModel 的子类,所以 Index 视图可以运转。但是 CreateEmployee 视图是 CreateEmployeeViewModel 的强类型视图,而 CreateEmployeeViewModel 不是 BaseViewModel 的子类,所以 CreateEmployee 出现了这样的错误。
第十二步:准备 CreateEmployeeViewModel
让 CreateEmployeeViewModel 继承 BaseViewModel,代码如下。
public class CreateEmployeeViewModel:BaseViewModel{...
第十三步:执行并测试
再一次测试。
这次的错误看起来与之前的不一样。错误真正的原因是,我们在 AddNew 行为中没有初始化 Header 和 Footer 的数据。
第十四步:初始化 Header 和 Footer 数据
将 AddNew 行为方法的代码改为如下所示。
public ActionResult AddNew(){ CreateEmployeeViewModel employeeListViewModel = new CreateEmployeeViewModel(); employeeListViewModel.FooterData = new FooterViewModel(); employeeListViewModel.FooterData.CompanyName = "StepByStepSchools";//Can be set to dynamic value employeeListViewModel.FooterData.Year = DateTime.Now.Year.ToString(); employeeListViewModel.UserName = User.Identity.Name; //New Line return View("CreateEmployee", employeeListViewModel);}
第十五步:在 SaveEmployee 中初始化 Header 和 Footer 数据
类似于 SaveEmployee 行为方法一样,我们更改其代码如下。
public ActionResult SaveEmployee(Employee e, string BtnSubmit){ switch (BtnSubmit) { case "Save Employee": if (ModelState.IsValid) { ... } else { CreateEmployeeViewModel vm = new CreateEmployeeViewModel(); ... vm.FooterData = new FooterViewModel(); vm.FooterData.CompanyName = "StepByStepSchools";//Can be set to dynamic value vm.FooterData.Year = DateTime.Now.Year.ToString(); vm.UserName = User.Identity.Name; //New Line return View("CreateEmployee", vm); // Day 4 Change - Passing e here } case "Cancel": return RedirectToAction("Index"); } return new EmptyResult();}
第十六步:执行并测试
按下 F5,然后执行应用。
Lab 25 的 Q&A
RenderBody 是用于做什么的?
当我们第一次创建 Layout 页面时,我们有一个 Razor 声明如下。
@Html.RenderBody()
现在让我们来理解下它是做什么的。在内容页面上,我们正常地定义区域,这些区域在布局页声明。
但是奇怪的是,Razor 允许我们在区域外定义一些内容。在内容页面上,所有非区域内的内容将会被 RenderBody 函数呈现。
下图将会更好地进行解释。
我们有嵌套的布局吗?
答案是肯定的。我们能创建一个嵌套了其它布局页的布局页。语法是一样的。
在每一个视图中都指定布局页是必须的吗?
你能够在 Views 文件夹下发现一个特殊的布局页,称为「__ ViewStart.cshtml」。在其内部设定定义,将会应用于所有视图。
例如,在「__ ViewStart.cshtml」中放置如下的代码,将会使「_Layout.cshtml」适用于所有视图的布局。
@{ Layout = "~/Views/Shared/_Layout.cshtml";}
在每一个行为方法中,是否都需要放置 Header 和 Footer 的数据代码?
答案是否定的。我们可以运用 Action 过滤器来避免这种重复。我们将会在接下来的实验中实践。
在子视图中定义所有区域是否是必须的?
答案是肯定的。如果 Section 的声明为必须的,那么默认值是 True。
@RenderSection("HeaderSection",false) // Not required@RenderSection("HeaderSection",true) // required@RenderSection("HeaderSection") // required
5. Lab 26 — 运用 Action 过滤器让 Header 和 Footer 数据更高效
在 Lab 23 中,我们已经知道了 ActionFilter 的优势,现在我们来看它的第二点优势。
第一步:从行为方法中删除冗余代码
从 Index,AddNew 和 SaveEmployee 方法中删除 Header 和 Footer 数据的代码。
Header 代码如下。
bvm.UserName = HttpContext.Current.User.Identity.Name;
Footer 代码如下。
bvm.FooterData = new FooterViewModel();bvm.FooterData.CompanyName = "StepByStepSchools";//Can be set to dynamic valuebvm.FooterData.Year = DateTime.Now.Year.ToString();
第二步:创建 HeaderFooterFilter
在 Filters 文件夹下创建一个类,命名为 HeaderFooterFilter,然后通过将它继承 ActionFilterAttribute 类来将其升级 Action 过滤器。
第三步:升级 ViewModel
在 HeaderFooterFilter 类中重写 OnActionExecuted。在这个方法中我们将会得到当前的视图模型,然后将其附上 Header 和 Footer 数据。
public class HeaderFooterFilter : ActionFilterAttribute{ public override void OnActionExecuted(ActionExecutedContext filterContext) { ViewResult v = filterContext.Result as ViewResult; if(v!=null) // v will null when v is not a ViewResult { BaseViewModel bvm = v.Model as BaseViewModel; if(bvm!=null)//bvm will be null when we want a view without Header and footer { bvm.UserName = HttpContext.Current.User.Identity.Name; bvm.FooterData = new FooterViewModel(); bvm.FooterData.CompanyName = "StepByStepSchools";//Can be set to dynamic value bvm.FooterData.Year = DateTime.Now.Year.ToString(); } } }}
OnActionExecuted 方法用于添加行为方法执行的逻辑操作。
第四步:附上过滤器
在 Index,AddNew 和 SaveEmployee 方法中附上 HeaderFooterFilter。
[HeaderFooterFilter]public ActionResult Index(){ EmployeeListViewModel employeeListViewModel = new EmployeeListViewModel();...}...[AdminFilter][HeaderFooterFilter]public ActionResult AddNew(){ CreateEmployeeViewModel employeeListViewModel = new CreateEmployeeViewModel(); //employeeListViewModel.FooterData = new FooterViewModel(); //employeeListViewModel.FooterData.CompanyName = "StepByStepSchools";...}...[AdminFilter][HeaderFooterFilter]public ActionResult SaveEmployee(Employee e, string BtnSubmit){ switch (BtnSubmit) { ...
第五步:执行并测试
按下 F5,执行应用。
6. 总结
这里我们已经完成了第五天的学习。接下来的第六天学习是最困难的,也是最有意思的。
继续保持学习的热情吧!
原文地址:
本文系 工程师编译整理。OneAPM 是领域的新兴领军企业,能帮助企业用户和开发者轻松实现:缓慢的程序代码和 SQL 语句的实时抓取。想阅读更多技术文章,请访问 。