mvc 数据的流转
在 Controller 中获取状态数据
我们经常需要访问客户端提交过来的数据,比如 QueryString 值、表单值和通过路由系统来自 URL 的参数值,这些值都可称为状态数据。下面是 Controller 中获取状态数据的三个主要来源:
- 一系列的上下文对象。
- 传递给 Action 方法的参数。
- 显式的调用框架的模型绑定(Model Binding)特性。
从上下文对象中获取状态数据
获取状态数据最直接的方法就是从上下文对象中提取。当你创建了一个继承自 Controller 类的 Controller 时,可以通过一系列的属性可以方便的访问到和请求相关的数据,这些属性包括 Request、Response、RouteData、HttpContext 和 Server,每一个都提供了请求相关的不同类型的信息。下面列出了最常的上下文对象:
在 Action 方法中可以使用任意上下文对象来获取请求相关的信息,如下面在 Action 方法中所演示的:
... public ActionResult RenameProduct() { //访问不同的上下文对象 string userName = User.Identity.Name; string serverName = Server.MachineName; string clientIP = Request.UserHostAddress; DateTime dateStamp = HttpContext.Timestamp; AuditRequest(userName, serverName, clientIP, dateStamp, "Renaming product"); //从POST请求提交的表单中获取数据 string oldProductName = Request.Form["OldName"]; string newProductName = Request.Form["NewName"]; bool result = AttemptProductRename(oldProductName, newProductName); ViewData["RenameResult"] = result; return View("ProductRenamed"); } ...
这些上下对象不用特意去记,用的时候,你可以通过VS的智能提示来了解这些上下文对象。
使用 Action 方法参数获取状态数据
在本系列的前面的文章中,我们已经知识如何通过 Action 参数来接收数据,这种方法和上面的从上下文对象中获取相比,它更为简洁明了。比如,我们有下面这样一个使用上下文对象的 Action 方法:
public ActionResult ShowWeatherForecast() { string city = (string)RouteData.Values["city"]; DateTime forDate = DateTime.Parse(Request.Form["forDate"]); // do something ... return View(); }
我们可以像下面这样使用 Action 方法参数来重写它:
public ActionResult ShowWeatherForecast(string city, DateTime forDate) { // do something ... return View(); }
它不仅易读性强,也方便进行单元测试。
Action 方法的参数不允许使用 ref 和 out 参数,这是没有意义的。
MVC 框架通过检查上下文对象来为 Action 方法的参数提供值,它的名称是不区分大小写的,比如 Action 方法的 city 参数的值可以是通过 Request.Form["City"] 来获取的。
理解 Action 方法的参数是如何被赋值的
Controller 类通过 MVC 框架的 value provider 和 model binder 组件来为 Action 方法获取参数的值。
value provider 提供了一系列Controller中可以访问到的值,在内部它通过从 Request.Form、Request.QueryString、Request.Files 和 RouteData.Values 等上下文对象中提取数据(键值集合),然后把数据传递给 model binder,model binder 试图将这些数据与Action方法的参数进行匹配。默认的 model binder 可以创建和赋值给任何.NET类型对象参数(即 Action 方法的参数),包括集合和自定义的类型。
在这不对 model binder 进行介绍,我将在本系列的后续博文中对其进行专门的介绍。
几种从 Action 传递数据到 View 的方式
我们经常需要在 Action 方法中传递数据到一个 View 中,MVC 框架为此提供了一些很方便的操作。下面简单简介几种常用的方式。
View Model 对象
通过 View Model 对象传递数据给View,这是最常用的一种,在 Acton 方法执行结束时通过 View 方法传递 View Model 对象给 View,如下代码所示:
... public ViewResult Index() { DateTime date = DateTime.Now; return View(date); }
在 View 中我们通过 Model 属性来使用传递过来的 View Model 对象,如下:
@model DateTime @{ ViewBag.Title = "Index"; } <h2>Index</h2> The day is: @Model.DayOfWeek
在 Razor 视图引擎中,@model 的作用是声明 odel 属性的类型,省去了类型转换的麻烦,而 @Model 是V iew Model 对象的引用。
ViewBag、ViewData 和 TempData 属性
ViewBag、ViewData 和 TempData 都是 Controller 和 View 中能访问到的属性,都是用来存储小量的数据,他们的区别如下:
- ViewBag,是一个动态(dynamic)的弱类型,在程序运行的时候解析,是 MVC3 中新增的特性,只在当前View有效。
- ViewData,是一个字典集合,也是只在当前View有效,性能比 ViewBag 高,但是使用的时候需要类型转换。
- TempData,也是字典集合,一般用于两个请求之间临时缓存内容或页面间传递消息,保存在 Session 中,使用完以后则从 Session 中被清除。
下面是三者使用的例子,先在 Controller 中分别用三者存储小数据:
public class DerivedController : Controller { public ActionResult Index() { ViewBag.DayOfWeek = DateTime.Now.DayOfWeek; ViewData["DayOfMonth"] = DateTime.Now.Day; return View(); } public ActionResult ProduceOutput() { TempData["Message"] = "Warning message from Derived Controller."; return Redirect("/Home/Index"); } }
在 Views/Derived 目录下的 Index.cshtml 中,取出 ViewBag 和 ViewData 中的存储的数据:
... Day of week from ViewBag: @ViewBag.DayOfWeek <p /> Day of month from ViewData: @ViewData["DayOfMonth"]
在 Views/Home 目录下的 Index.cshtml 中,取 TempData 中的数据如下:
...
@TempData["Message"]
当请求 /Derived/ProduceOutput 时,ProduceOutput 方法将一条消息存到 TempData 中,并跳转到 /Home/Index。
下面是分别是将URL定位到 /Derived/Index 和 /Derived/ProduceOutput 时的结果:
一般在当前 View 中使用 ViewBag 或 ViewData,在两个请求之间传递临时数据用 TempData。由于 TempData 被使用后即被释放,所以如果要二次使用 TempData 中的数据就需要将其存到其他变量中。