ASP.NET MVC Model元数据及其定制: 初识Model元数据

简介:

Contronoller激活之后,ASP.NET MVC会根据当前请求上下文得到目标Action的名称,然后解析出对应的方法并执行之。在整个Action方法的执行过程中,Model元数据的解析是一个非常重要的环节。ASP.NET MVC中的Model实际上View Model,表示最终绑定到View上的数据,而Model元数据描述了Model的数据结构,以及Model的每个数据成员的一些特性。正是有了Model元数据的存在,才使模板化HTML的呈现机制成为可能。此外,Model元数据支撑了ASP.NET MVC的Model验证体系,因为针对Model的验证规则正是定义在Model元数据中。ASP.NET MVC的Model元数据通过类型ModelMetadata表示。ModelMetadata通过一系列的属性描述了Model及其成员相关的元数据信息,在正式介绍这些元数据选项之前,我们很有必要先来了解一下Model元数据层次化结构。[本文已经同步到《How ASP.NET MVC Works?》中]

目录
一、Model元数据层次化结构
二、基本Model元数据信息
三、Model元数据的定制
    UIHintAttribute
    HiddenInputAttribute与ScaffoldColumnAttribute
    DataTypeAttribute与DisplayFormatAttribute
    EditableAttribute与ReadOnlyAttribute
    DisplayAttribute与DisplayNameAttribute
    RequiredAttribute
四、IMetadataAware接口
    AllowHtmlAttribute
    实例演示:创建实现IMetadataAware接口的特性定制Model元数据

一、Model元数据层次化结构

作为Model的数据类型可以一个和简单的字符串或者是一个值类型的对象,也可能是一个复杂的数据类型。对于一个复杂的数据类型,基于类型本身和数据成员的元数据都通过一个ModelMetadata来表示,而某个数据成员又可能是一个复杂类型,所以通过ModelMetadata对象表示的Model元数据实际上具有一个树形层次化结构。

举个例子,我们具有一个具有如下定义的表示联系人的数据类型Contact。属性Name、PhoneNo、EmailAddress和Address分别代表姓名、电话号码、邮箱地址和联系地址。联系地址通过另一个数据类型Address表示,属性Province、City、District和Street分别表示所在省份、城市、城区和街道。

   1: public class Contact
   2: {
   3:     public string Name { get; set; }
   4:     public string PhoneNo { get; set; }
   5:     public string EmailAddress { get; set; }
   6:     public Address Address { get; set; }
   7: }
   8: public class Address
   9: {
  10:     public string Province { get; set; }
  11:     public string City { get; set; }
  12:     public string District { get; set; }
  13:     public string Street { get; set; }
  14: }

如果将Contact类型作为Model,作为其元数据的ModelMetadata不仅仅具有Contact类型本身和其属性成员的描述,由于其Address属性是一个复杂类型,元数据还需要描述定义在该类型中的4个属性成员。下图反映基于Contact类型的Model元数据的层次化结构。

image

表示Model元数据的ModelMetadata类型不仅用于描述某个作为Model的数据类型,还用于递归地描述其所有属性成员(不包含字段成员),所以ModelMetadata具有一个树型层次化结构,这也可以从ModelMetadata的定义可以看出来。

   1: public class ModelMetadata
   2: {
   3:     //其他成员
   4:     public virtual IEnumerable<ModelMetadata> Properties { get; }
   5: }

如上面的代码片断所示,ModelMetadata具有一个类型为IEnumerable<ModelMetadata>的只读属性Properties,表示用于描述属性/字段成员的ModelMetadata集合。ModelMetadata的层次化结构可以通过如下图所示的UML来体现。由于基于类型的ModelMetadata和基于数据成员的ModelMetadata是一种包含关系,我们可以将前者称为后者的容器(Container)。

image

二、基本Model元数据信息

基于作为Model类型创建的元数据主要是为View实现模板化HTML呈现和数据验证服务的,我们可以通过在类型和数据成员上应用相应的特性控制Model在View中的呈现方式或者定义相应的验证规则。在介绍声明式Model元数据编程方式之前,我们先来介绍表示Model元数据的ModelMetadata类型中与UI呈现和数据验证无关的基本属性。

   1: public class ModelMetadata
   2: {
   3:    //其他成员
   4:     public Type ModelType { get; }
   5:     public virtual bool IsComplexType { get; }
   6:     public bool IsNullableValueType { get; }
   7:     public Type ContainerType { get; }
   8:  
   9:     public object Model { get; set; }
  10:     public string PropertyName { get; }
  11:  
  12:     public virtual Dictionary<string, object> AdditionalValues { get; }
  13:     protected ModelMetadataProvider Provider { get; set; }
  14: }

如上面的代码片断所示,ModelMetadata具有四个类型相关的只读属性。ModelType表示Model本身的类型,比如说针对上面定义的Contact类型的ModelMetadata对象,其ModelType属性值就是Contact类型;而针对其属性的ModelMetadata对象,则具体的属性类型作为它的ModelType属性。属性IsComplexType和IsNullableValueType分别表示以ModelType属性表示的Model类型是一个复杂类型和可空值类型。

在这里判断某个类型是否是复杂类型的条件只有一个,即是否允许字符串类型向该类型的转换。具体来说,将通过ModelType属性表示的Model类型作为传输传入TypeDescriptor的静态方法GetConverter得到一个TypeConverter对象,如果TypeConverter不支持从字符串类型的转换则认为是复杂类型。所以所有的基元类型(Primative Type)均不是复杂类型,所有可空值类型(Nuallable Type)均不是是复杂类型。对于一个默认为复杂类型的自定义的数据类型,我们可以通过TypeConverterAttribute特性标注一个支持从字符串类型转换的TypeConverter使之转变成非复杂类型。

如下面的代码片断所示,我们定义了一个表示二维坐标的Point类型,由于我们在该类型上应用了一个TypeConverterAttribute特性指定了类型为PointTypeConverter的TypeConverter。由于PointTypeConverter支持从字符串到Point类型之间的转换,所以Point并不是一个复杂类型。

   1: [TypeConverter(typeof(PointTypeConverter))]
   2: public class Point
   3: {
   4:     public double X { get; set; }
   5:     public double Y { get; set; }
   6:     public Point(double x, double y)
   7:     {
   8:         this.X = x;
   9:         this.Y = y;
  10:     }
  11:     public static Point Parse(string point)
  12:     { 
  13:         string[] split = point.Split(',');
  14:         if(split.Length != 2)
  15:         {
  16:             throw new FormatException("Invalid point expression.");
  17:         }
  18:         double x;
  19:         double y;
  20:         if (!double.TryParse(split[0], out x) || 
  21:             !double.TryParse(split[1], out y))
  22:         { 
  23:             throw new FormatException("Invalid point expression.");
  24:         }
  25:         return new Point(x, y);
  26:     }
  27: }
  28: public class PointTypeConverter : TypeConverter
  29: {
  30: public override bool CanConvertFrom(ITypeDescriptorContext context, 
  31:    Type sourceType)
  32:     {
  33:         return sourceType == typeof(string);
  34:     }
  35:  
  36: public override object ConvertFrom(ITypeDescriptorContext context, 
  37:     CultureInfo culture, object value)
  38:     {
  39:         if (value is string)
  40:         {
  41:             return Point.Parse(value as string);
  42:         }
  43:         return base.ConvertFrom(context, culture, value);
  44:     }
  45: }

通过上面的介绍我们知道表示Model元数据的ModelMetadata具有一个树形的层次结构,某个节点可以看成了其子节点的容器,而ContainerType这是表述容器的类型。同样以前面定义的Contact类型为例,基于该类型本身的ModelMetadata是整个层次树的根节点,所以ContainerType返回Null;基于属性Address的ModelMetadata的ContainerType属性返回Contact类型;而基于Address的属性Province的ModelMetadata的ContainerType属性值则是Address类型。

ModelMetadata的Model属性代表的是作为Model的对象。如果将上面定义的Contact对象作为View的Model,那么表示该Model本身元数据的ModelMetadata对象来说,其Model属性就是该Contact对象;对于基于Contact某个属性的ModelMetadata对象则将对应的属性值作为自己的Model。值得一提的是,该属性是可读可写的,意味着我们可以随时根据需要改变它。另一个属性PropertyName表示对应的属性值,对于根节点ModelMetadata来说,该属性总是返回Null。

ModelMetadata的AdditionalValues属性返回一个字典对象,用于存储一些自定义的属性,字典元素的Key和Value分别代表自定义属性的名称和值。对于自定义属性的添加,我们可以在数据类型或者其数据成员上应用AdditionalMetadataAttribute特性来实现。如下面的代码片断所示,AdditionalMetadataAttribute具有Name和Value两个只读属性分别表示自定义属性的名称和值,它们直接通过构造函数进行初始化。AdditionalMetadataAttribute实现了IMetadataAware接口,对于Model元数据的定制来说,这是一个非常重要并且实用的接口,我们将在下篇对其进行单独介绍。

   1: [AttributeUsage(AttributeTargets.Interface | AttributeTargets.Property | 
   2:     AttributeTargets.Class, AllowMultiple=true)]
   3: public sealed class AdditionalMetadataAttribute : Attribute, IMetadataAware
   4: {
   5:     public AdditionalMetadataAttribute(string name, object value);
   6:     public void OnMetadataCreated(ModelMetadata metadata);
   7:     public string Name { get; }
   8:     public object Value { get;}
   9: }

ModelMetadata的属性Provider是一个ModelMetadataProvider对象,顾名思义,ModelMetadataProvider是ModelProvider的提供者。ModelProvider是ASP.NET MVC整个Model元数据系统的核心,我们将在后续的博文中对其进行单独讲述。

ASP.NET MVC Model元数据及其定制: 初识Model元数据
ASP.NET MVC Model元数据及其定制: Model元数据的定制
ASP.NET MVC Model元数据及其定制:一个重要的接口IMetadataAware


作者:蒋金楠
微信公众账号:大内老A
微博: www.weibo.com/artech
如果你想及时得到个人撰写文章以及著作的消息推送,或者想看看个人推荐的技术资料,可以扫描左边二维码(或者长按识别二维码)关注个人公众号(原来公众帐号 蒋金楠的自媒体将会停用)。
本文版权归作者和博客园共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。
相关文章
|
3月前
|
开发框架 前端开发 .NET
ASP.NET CORE 3.1 MVC“指定的网络名不再可用\企图在不存在的网络连接上进行操作”的问题解决过程
ASP.NET CORE 3.1 MVC“指定的网络名不再可用\企图在不存在的网络连接上进行操作”的问题解决过程
41 0
|
1月前
|
开发框架 前端开发 .NET
进入ASP .net mvc的世界
进入ASP .net mvc的世界
29 0
|
1月前
mvc.net分页查询案例——mvc-paper.css
mvc.net分页查询案例——mvc-paper.css
5 0
|
1月前
|
开发框架 前端开发 .NET
C# .NET面试系列六:ASP.NET MVC
<h2>ASP.NET MVC #### 1. MVC 中的 TempData\ViewBag\ViewData 区别? 在ASP.NET MVC中,TempData、ViewBag 和 ViewData 都是用于在控制器和视图之间传递数据的机制,但它们有一些区别。 <b>TempData:</b> 1、生命周期 ```c# TempData 的生命周期是短暂的,数据只在当前请求和下一次请求之间有效。一旦数据被读取,它就会被标记为已读,下一次请求时就会被清除。 ``` 2、用途 ```c# 主要用于在两个动作之间传递数据,例如在一个动作中设置 TempData,然后在重定向到另
99 5
|
3月前
|
XML 前端开发 定位技术
C#(NET Core3.1 MVC)生成站点地图(sitemap.xml)
C#(NET Core3.1 MVC)生成站点地图(sitemap.xml)
25 0
|
3月前
|
前端开发
.net core mvc获取IP地址和IP所在地(其实是百度的)
.net core mvc获取IP地址和IP所在地(其实是百度的)
124 0
|
8月前
|
存储 开发框架 前端开发
[回馈]ASP.NET Core MVC开发实战之商城系统(五)
经过一段时间的准备,新的一期【ASP.NET Core MVC开发实战之商城系统】已经开始,在之前的文章中,讲解了商城系统的整体功能设计,页面布局设计,环境搭建,系统配置,及首页【商品类型,banner条,友情链接,降价促销,新品爆款】,商品列表页面,商品详情等功能的开发,今天继续讲解购物车功能开发,仅供学习分享使用,如有不足之处,还请指正。
116 0
|
5月前
|
开发框架 自然语言处理 前端开发
基于ASP.NET MVC开发的、开源的个人博客系统
基于ASP.NET MVC开发的、开源的个人博客系统
52 0
|
8月前
|
SQL 开发框架 前端开发
[回馈]ASP.NET Core MVC开发实战之商城系统(完:内附源码)
经过一段时间的准备,【ASP.NET Core MVC开发实战之商城系统】已经完成,目前代码已开发完成,先将全部内容整理分享,如有不足之处,还请指正。
107 0
|
8月前
|
开发框架 前端开发 .NET
[回馈]ASP.NET Core MVC开发实战之商城系统(六)
经过一段时间的准备,新的一期【ASP.NET Core MVC开发实战之商城系统】已经开始,在之前的文章中,讲解了商城系统的整体功能设计,页面布局设计,环境搭建,系统配置,及首页【商品类型,banner条,友情链接,降价促销,新品爆款】,商品列表页面,商品详情,购物车等功能的开发,今天继续讲解订单管理功能开发,仅供学习分享使用,如有不足之处,还请指正。
215 0