ASP.NET MVC5高级编程 之 视图

1.1理解视图约定

当创建一个项目模版时,可以注意到,项目以一种非常具体的方式包含了一个结构化的Views目录。在每一个控制器的View文件夹中,每一个操作方法都有一个同名的视图文件与其对应。这就提供了视图与操作方法关联的基础。

1 public ActionResult Index()
2 {
3      return View();  
4 }

视图选择逻辑在/Views/ControllerName目录(这里就是去掉Controller后缀的控制器名)下查找与操作方法同名的视图。此处选择的是/Views/Home/Index.cshtml。

与ASP.NET MVC中的大部分方法一样,这一约定是可以重写的。想让Index操作方法渲染一个不同的视图,可以向其提供一个不同的视图名称,代码如下:

1 public ActionResult Index()
2 {
3      return View("NotIndex");  
4 }

对于上面的编码,操作方法依然在/Views/Home目录中查找视图,但选择的不再是Index.cshtml,而是NotIndex.cshtml。

如果需要制定完全位于不同目录结构中的视图,编码如下:

1 public ActionResult Index()
2 {
3      return View("~/Views/Example/Index.cshtml");  
4 }

 

 1.2 强类型视图

假设需要编写一个显示Album实例列表的视图,一种方法是将专辑添加到ViewBag中,然后在视图中进行迭代。

 1         public ActionResult List()
 2         {
 3             var albums = new List<Album>();
 4             for (int i = 0; i < 10; i++)
 5             {
 6                 albums.Add(new Album { Title = "Product" + i });
 7             }
 8             ViewBag.Albums = albums;
 9             return View();
10         }

然后,再在视图中迭代显示,如下代码:

1 <ul>
2  @foreach (Album a in (ViewBag.Albums as IEnumerable<Album>))
3 {
4    <li>@a.Tilte</li>
5 }
6 </ul>

 注意在枚举之前需要将动态的ViewBag.Albums转换为IEnumerable<Album>类型。为了使代码整洁,可以使用dynamic关键字,但是当访问每个Album对象的属性时,就不能再使用智能感知功能。

1 <ul>
2  @foreach (dynamic p in ViewBag.Albums)
3 {
4    <li>@p.Tilte</li>
5 }
6 </ul>

强类型视图既能获得dynamic的简洁语法,又能获得强类型和编译时检查的好处(比如正确的输入属性和方法名称)。强类型视图允许设置视图的模型类型。因此可以从控制器向视图传递一个在两端都是强类型的模型对象,从而获得智能感知、编译器检查等好处。

在Controller方法中,可以通过向重载的View方法中传递模型实例来指定模型,代码如下:

1     public ActionResult List()
2     {
3         var Musics = new List<MusicModels>();
4         for (int i = 0; i < 10; i++)
5         {
6             Musics.Add(new MusicModels { MusicName = "MusicName" + i.ToString() });
7         }
8         return View(Musics);
9     }

下一步是告知视图哪种类型的模型正在使用@model声明。但要注意这里需要输入模型类型的完全限定类型名(名称空间和类型名称),如下所示

1 @model IEnumerable<MvcMusicStore.Models.MusicModels>
2 <ul>
3     @foreach(MvcMusicStore.Models.MusicModels music in Model)
4     <li>@music.SingerName</li>
5 </ul>

如果不想输入模型类型的完全限定类型名,可使用@using关键字,如下所示

1  @using MvcMusicStore.Models
2  @model IEnumerable<MusicModels>
3  <ul>
4      @foreach(MusicModels music in Model)
5      <li>@music.SingerName</li>
6  </ul>

对于在视图中经常使用的名称空间,好的方法是在Views目录下的web.config文件中声明:

<add namespace="MvcMusicStore.Models">

 

1.3 理解ViewBag、ViewData和ViewDataDictionary

之前介绍了使用ViewBag从控制器向视图传递信息,然后介绍了传递强类型模型。现实中,这些都是通过ViewDataDictionary传递的。

从技术的角度看,数据从控制器传送到视图是通过一个名为ViewData的ViewDataDictionary(这是一个特殊的字典类)。我们可以使用标准的字典语法设置或读取其中的值:

ViewData["CurrentTime"] = DateTime.Now;

尽管这种语法现在也能用,但是MVC3提供了更简单的语法,可以利用C#4的dynamic关键字。ViewBag是ViewData的动态封装器。这样我们就可以按照下面的方式来设置值:

ViewBag.CurrentTime = DateTime.Now;

 ViewBag.CurrentTime和ViewData["CurrentTime"] 起到了等同的作用。

一般来说,大部分代码使用ViewBag,而不是ViewData,这两种语法并不存在技术上的差异,仅仅是因为ViewBag相对于字典语法而言看上去好看。

注意,ViewBag和ViewData的差异:

  • 只有当要访问的关键字是一个有效的C#标识符时,ViewBag才起作用。例如,如果在ViewData["Key With Spaces"]中存放一个值,那么就不用使用ViewBag访问,因为无法通过编译。
  • 动态值不能作为一个参数传递给扩展方法,因为C#编译器为了选择正确的扩展方法,在编译时必须知道每一个参数的真正类型。

 

2.视图模型

在操作方法上右击 --> “添加视图” 

弹出添加视图页:

  • View name:当从一个操作方法的上下文中打开这个对话框时,视图的名称默认被填充为操作方法的名称。视图的名称是必须有的。
  • Template:一旦选择一个模型类型,就可以选择一个基架模版。这些模版利用Visual Studio模版系统来生成基于选择模型类型的视图。
  • 引用脚本库:这个选项用来指示要创建的视图是否应该包含指向JavaScript库(如果对视图有意义的话)的引用。默认情况下,_Layout.cshtml文件既不引用jQuery Validation库,也不引用Unobtrusive jQuery Validation库,只引用主jQuery库。

      当创建一个包含数据条目表单的视图(如Edit视图或者Create视图)时,选择这个选项会添加对jqueryval捆绑的脚本引用。如果要实现客户端验证,那么这些库就是必须的。除这种情况外,完全可以忽略这个复选框。

  • 创建一个分部视图:选择这个意味着要创建的视图不是一个完整的视图,因此,Layout选项是不可选用的。生成的部分视图除了在其顶部没有<html>标签和<head>标签外,很像一个常规的视图。
  • 使用布局页:这个选项决定了要创建的视图是否引用布局,还是成为一个完全独立的视图。如果选择使用默认的布局,就没必要指定一个布局了,因为在_ViewStart.cshtml文件中已经指定了布局。这个选项是用来重写默认布局文件的。

 

2.2 Razor视图引擎

ASP.NET MVC中提供了两种不同的视图引擎:较新的Razor视图引擎和较早的WebForms视图引擎。

Razor中的核心转换字符是(@),这个单一字符用作标记-代码的转换字符,有时也反过来用作代码-标记的转换字符。

这里一共有两种基本类型的转换:代码表达式和代码快。

<h1>Listing @items.Length items.</h1>

表达式@items.Length是作为隐式表达式来求解的,然后输出表达式的值3。这里不需要指出代码表达式的结束位置。

但是Razor自动从代码转回标记的能力,也带来了二义性的问题:

1 @{
2     string rootNamespace = "MyApp";
3 }
4 <span>@rootNamespace.Models</span>

这个示例想要的输出结果是:  <span>MyApp.Models</span>  ,然而实际会出现错误,提示string没有Models属性,此时需要通过圆括号解决:

1 @{
2     string rootNamespace = "MyApp";
3 }
4 <span>@(rootNamespace).Models</span>

这样可以告诉Razor,.Models是字面量文本,而不是代码表达式的一部分。

 

对于电子邮件地址时的情况,Razor可以辨别出邮件的模式,进而不处理这种形式的表达式:

<span>support@megacorp.com</span>

但是如果确实想将这种形式的字符串作为一个表达式,也需要合理用圆括号:

对于

<li>Item_@item.Length</li>

期望的输出结果是<li>Item_3</li>,但是Razor会将其按照字符串进行打印。

处理的方法是:

<li>Item_@(item.Length)</li>

有时也需要使用@符号来进行转义:

1 <p>
2  You should follow
3  @@aspnet
4 </p>

 

3.Razor语法示例

常见用途下的Razor语法;

  • 隐式代码表达式

代码表达式将被计算并将值写入到响应中,这就是视图中显示值的一般原理。

<span>@model.Message</span>
  • 显示代码表达式

代码表达式的值将被计算并写入到响应中,这就是在视图中显示值的一般原理

<span>1 + 2 = @(1 +2 )</span>
  • 无编码代码表达式

有些情况下,需要显式的渲染一些不应该采用HTML编码的值,这时可以采用Html.Raw方法来保证该值不被编码

<span>@Html.Raw(model.Message)</span>
  • 代码块

不像代码表达式先求的表达式的值,然后再输出到响应,代码块是简单地执行代码部分

1 @{
2    int x = 123;
3    string y = "because."
4 }
  • 文本和标记相结合

这个例子显示了在Razor中混用文本和标记的概念,具体如下:

1 @foreach (var item in items)
2 {
3    <span>Item @item.Name.</span>
4 }
  • 混合代码和纯文本

Razor查找标签的开始位置以确定何时将代码转换为标记。然而,有时可能想在一个代码块之后立即输出纯文本。例如,在下面的这个例子中就是展示如何在一个条件语句块中显示纯文本

1 @if (showMessage)
2 {
3    <text>this is plain text</text>
4 }

或者

1 @if (showMessage)
2 {
3    @:this is plain text.
4 }

第一种使用<text>标签,这样只是把标签内容写入到响应中,而标签本身则不写入。第二种方式使用一种特殊的语法,实现代码到纯文本的转换,但是这种方法每次只能作用于一行文本。

  • 转义代码分隔符

可使用“@@”来编码“@”以达到显示“@”的目的。此外,时钟都可以选择使用HTML编码来实现。

Razor:

the asp.net twitter handle is &#64;aspnet

或者

the asp.net twitter handle is @@aspnet
  • 代码注释
1 @*
2 代码块
3 *@

 

4.布局

Razor的布局有助于使应用程序的多个视图保持一致的外观。可以使用布局为网站定义公共模版(或只是其中的一部分)。公公模版包含一个或多个占位符,应用程序中的其他视图为它们提供内容。从某些角度看,布局很像视图的抽象基类。如下则是一个简单的布局:

 1 <!DOCTYPE html>
 2 <html>
 3     <head>
 4         <title>@ViewBag.Title</title>
 5     </head>
 6     <body>
 7         <h1>@ViewBag.Title</h1>
 8         <div id="main-content">@RenderBody()</div>
 9         <footer>@RenderSection("Footer")</footer>
10     </body>
11 </html>

对应视图的代码如下:

 1 @{
 2     Layout = "~Views/Shared/SiteLayout.cshtml";
 3     ViewBag.Title = "The Index";
 4 }
 5 
 6 <p>this is the main content!</p>
 7 
 8 @section Footer{
 9     this is the <strong>footer</strong>.
10 }

@section语法为布局中定义的一个节指定了内容。

默认情况下,视图必须为布局中定义的每一个节提供内容。如果向当前的布局中添加一个新节时,会使得引用该布局的每一个视图都不能正常运行。

但是,RenderSection方法有一个重载版本,允许指定不需要的节。可以给required参数传递一个false值来标记Footer节是可选的。

<footer>@RenderSection("Footer", required: false)</footer>

有时也在视图中定义一些默认内容

 1 <footer>
 2     @if (IsSectionDefined("Footer"))
 3     {
 4         RenderSection("Footer");
 5     }
 6     else
 7     { 
 8         <span>this is the default footer</span>
 9     }
10 </footer>

 

5.ViewStart

在创建一个默认的ASP.NET MVC项目后,会在Views目录下自动添加一个_ViewStart.cshtml文件,它指定了一个默认布局

1 @{
2    Layout = "~/Views/Shared/_Layout.cshtml"
3 }

如果多个视图都使用都使用同一个布局,就会产生冗余。_ViewStart.cshtml中的代码先于任何视图运行,所以一个视图可以重写Layout属性的默认值,从而重新选择了一个不同的布局。如果一组视图拥有共同的设置,那么_ViewStart.cshtml中的代码可以用来对共同的视图进行统一配置。如果有视图需要覆盖统一的设置,只需要修改对应的属性值即可。

 

6.指定部分视图

 除了返回视图之外,操作方法也可以通过PartialView方法以PartialViewResult的形式返回部分视图:

1 public class HomeController : HomeController
2 {
3     public ActionResult Message()
4     {
5         ViewBag.Message = "this is a partial view.";
6         return PartialView();
7     }
8 }

这种情形下,渲染的是视图Message.cshtml,但是如果布局是由_ViewStart.cshtml页面指定(而不是直接在视图中)的,将无法渲染布局。

除了不能指定布局之外,部分视图看起来和正常视图没有分别:

<h2>@ViewBag.Message</h2>

在使用Ajax技术进行更新时,部分视图是很有用的。示例使用jQuery将一个部分视图的内容加载到一个使用了Ajax调用的当前视图中:

1 <div id="result"></div>
2 @section scripts{
3 <script type="text/javascript">
4 $(function(){
5 $('#result').load('/home/message');
6 });
7 </script>
8 }

代码使用jQuery的load方法向Message操作方法发出一个Ajax请求,而后使用请求的结果更新id属性值为result的DIV元素。

 

posted @ 2017-03-06 16:52  imstrive  阅读(5097)  评论(1编辑  收藏  举报