ASP.NET MVC学习之模型模板篇

一.前言

如果你使用ASP.NET MVC制作后台一定会爱上它的EditorForModal、DisplayForModal和LabelForModal方法，因为这些方法可以将模型直接变成对应的标签，省了不少事，但是对于一些苛刻的人来说，一定想自定义，下面我们会先介绍如何使用，然后介绍如何自定义。

二.正文

1.输出模型

首先我们要新建一个Home控制器，对应的还要有一个Index动作，和Index视图，接着我们在Modal下新建一个Address类：

 namespace MvcStudy.Models
 {
     public class Address
     {
         public string Line1 { get; set; }
         public string Line2 { get; set; }
         public string City { get; set; }
         public string PostalCode { get; set; }
         public string Country { get; set; }
     }
 }

接着再新建一个Role枚举：

 namespace MvcStudy.Models
 {
     public enum Role
     {
         Admin,
         User,
         Guest
     }
 }

最后新建一个Person类：

 namespace MvcStudy.Models
 {
     public partial class Person
     {
         public int PersonId { get; set; }
         public string FirstName { get; set; }
         public string LastName { get; set; }
         public DateTime BirthDate { get; set; }
         public Address HomeAddress { get; set; }
         public bool IsApproved { get; set; }
         public Role Role { get; set; }
     }
 }

然后我们在Home控制器的Index方法中写入如下代码：

 namespace MvcStudy.Controllers
 {
     public class HomeController : Controller
     {
         public ActionResult Index()
         {
             Person p = new Person
             {
                 PersonId = ,
                 HomeAddress = new Address
                 {
                     City = "zj",
                     Country = "js",
                     Line1 = "",
                     Line2 = "",
                     PostalCode = "asdsa"
                 },
                 Role = Models.Role.User,
                 BirthDate = DateTime.Now,
                 FirstName = "y",
                 LastName = "zf",
                 IsApproved = false
             };
             return View(p);
         }
     }
 }

同时还要确保Index视图的model的类型是Person类型，如果不是可以在最顶部加上如下代码：

@model MvcStudy.Models.Person

接着我们打开Index视图，在其中写入@Html.EditorForModel()，运行之后我们可以看到页面上输出了该类的属性：

图 1.1

但是我们可以发现PersonId也输出了而且还可以编辑，这可不是我们所想要的，所以我们要在模型的PersonId上加上HiddenInput注解属性，重新编译后我们可以看到PersonId已经不可编辑了：

但是有时我们根本不想让它显示出来，这个时候我们需要修改HiddenInput注解属性，将DisplayValue设置为false即可，但是你可以通过查看页面的html源代码看到存在一个隐藏的input标签，当然如果你根本不想让这个属性存在于页面中我们可以将HiddenInput修改成[ScaffoldColumn(false)]即可。

通过图1.1我们可以发现label中显示的都是该属性的名称，并不符合实际的使用习惯，所以我们还要给这些属性加上该显示的名称：

 namespace MvcStudy.Models
 {
     public partial class Person
     {
         [ScaffoldColumn(false)]
         public int PersonId { get; set; }
         [Display(Name = "名")]
         public string FirstName { get; set; }
         [Display(Name = "姓")]
         public string LastName { get; set; }
         [Display(Name = "生日")]
         public DateTime BirthDate { get; set; }
         public Address HomeAddress { get; set; }
         [Display(Name = "是否启用")]
         public bool IsApproved { get; set; }
         [Display(Name = "角色")]
         public Role Role { get; set; }
     }
 }

重新编译之后我们可以看到页面变成了如下所示：

我们可以看到字符串都使用input去呈现，但是有时候这样并不符合实际情况，那么我们就要修改属性的DataType类型，比如我们将姓修改成富文本，修改Person代码：

 namespace MvcStudy.Models
 {
     public partial class Person
     {
         [ScaffoldColumn(false)]
         public int PersonId { get; set; }
         [Display(Name = "名")]
         [DataType(DataType.Text)]
         public string FirstName { get; set; }
         [Display(Name = "姓")]
         [DataType(DataType.MultilineText)]
         public string LastName { get; set; }
         [Display(Name = "生日")]
         [DataType(DataType.DateTime)]
         public DateTime BirthDate { get; set; }
         public Address HomeAddress { get; set; }
         [Display(Name = "是否启用")]
         public bool IsApproved { get; set; }
         [Display(Name = "角色")]
         public Role Role { get; set; }
     }
 }

然后我们重新编译之后可以看到最终想要的效果了，当然这些都是ASP.NET MVC根据类型自动判断的并选择对应的模板，所以我们也可以直接设置属性使用的模板，这样我们可以通过使用UIHint去指定模板的名称（其实就是视图的名称）。

2.将元数据用于分布类

现在开发网站模型都是工具自动生成了，如果按照我们上面的这种方法，一旦重新生成模型了，那么我们就需要重新将注解属性加上上去，既费时又费力。幸好ASP.NET MVC提供了解决方案，我们只需要为那个模型类加上一个分布类即可，比如下面我们将Person的注解属性全部转移到分布类中：

笔者新建了一个名为PersonExt的类：

 namespace MvcStudy.Models
 {
     public class PersonDataBindSource
     {
         [ScaffoldColumn(false)]
         public int PersonId { get; set; }
         [Display(Name = "名")]
         [DataType(DataType.Text)]
         public string FirstName { get; set; }
         [Display(Name = "姓")]
         [DataType(DataType.MultilineText)]
         public string LastName { get; set; }
         [Display(Name = "生日")]
         [DataType(DataType.DateTime)]
         public DateTime BirthDate { get; set; }
         public Address HomeAddress { get; set; }
         [Display(Name = "是否启用")]
         public bool IsApproved { get; set; }
         [Display(Name = "角色")]
         public Role Role { get; set; }
     }

     [MetadataType(typeof(PersonDataBindSource))]
     public partial class Person
     {
     }
 }

然后我们就可以删除Person类的注解属性了，重新编译可以看到最后的输出还是一样的。细心的读者会发现Address属性并没有输出，这是因为辅助器并不会递归查找，所以我们需要在Index视图中写入@Html.EditorFor(x => x.HomeAddress)即可。

3.使用自定义模板

通过上面的例子我们发现Role呈现出来的是输入框，但实际上应该是选择的，这个时候我们就需要自定义模板，首先我们在Views/Shared下新建一个EditorTemplates文件夹，然后新建一个Role视图，强类型为Role类型，并且不使用母版。然后在视图中写入如下代码：

 <select id="Role" name="Role">
     @foreach (Role value in Enum.GetValues(typeof(Role)))
     {
         <option value="@value" @(Model == value ?"selected='selected'":"")>@value</option>
     }
 </select>

接着刷新页面，我们就可以看到Role变成了下拉选择了：

当然文件夹的名称是一种规范，如果需要自定了Display模板，则新建DisplayTemplates文件夹，然后根据类型新建对应名称的视图，当然我们也可以新建一些ASP.NET MVC已经提供了模板的类型，而ASP.NET MVC会首先使用我们的模板而不是自带的。当然我们也可以通过UIHint指定模板。有时候我们需要设置标签的Id，那么我们可以通过ViewData.TemplateInfo.GetFullHtmlFieldId方法获取Id而ViewData.TemplateInfo.GetFullHtmlFieldName用来获取name，如果你对这些还不够满意，那么你可以通过ViewData.ModelMetadata中的属性获取模型中属性的全部信息。

4.传递参数到模板中

有时候我们需要在模型模板与模板之间传递自定义的参数，那么下面的方式将可以实现。首先我们在PersonExt文件中给BirthDate属性加上如下的注解属性：

 [AdditionalMetadata("val","test")]

该注解属性的第一个参数是Key，第二个是对应的参数，然后我们在Views/Shared/EditorTemplates中新建一个DateTime视图，并在其中写入如下代码：

 @model DateTime

 @{
     Layout = null;
 }

 @Html.TextBox(ViewData.TemplateInfo.GetFullHtmlFieldName("a"), Model)
 @if(ViewData.ModelMetadata.AdditionalValues.ContainsKey("val"))
 {
     @Html.Label(ViewData.ModelMetadata.AdditionalValues["val"].ToString())
 }

这里ModelMetadata的AdditionalValues属性保存了传递的自定义参数，上面我们首先判断是否存在Key为val的参数，然后在将val的值显示出来，重新编译之后刷新页面我们可以看到如下的效果：