ASP.NET MVC Model元数据(四)前言

前面的篇幅讲解了Model元数据生成的过程,并没有对Model元数据生成过程的内部和Model元数据结构的详细解释。看完本篇后将会对Model元数据有更清楚的了解,当然了也不会是特别全面的,因为后面还有篇幅。希望能给大家带来好的效果。

Model元数据

什么是Model元数据?

生成Model元数据的过程【一】

生成Model元数据的过程【二】

ModelMetaData的定义、详解

Model元数据应用(常用特性应用)-1

Model元数据应用(自定义视图模板)-2

Model元数据应用(IMetadataAware接口使用)-3

ModelMetaData的定义、详解

对于Model元数据的生成可否我们自己来定义呢?回答是肯定的,必须可以阿。MVC框架给我们提供了顶层基类,在调用的时候是从当前上下文中获取到系统默认实现类(或者是我们自定义的实现类)。我们来看一下示例代码1-1.

代码1-1

publicclassMyCustomModelMetadataProvider:DataAnnotationsModelMetadataProvider{protectedoverrideModelMetadataCreateMetadata(IEnumerable<Attribute>attributes,TypecontainerType,Func<object>modelAccessor,TypemodelType,stringpropertyName){DataAnnotationsModelMetadataresult=newDataAnnotationsModelMetadata(this,containerType,modelAccessor,modelType,propertyName,displayColumnAttribute);returnresult;}}

代码1-1中的MyCustomModelMetadataProvider类型继承自DataAnnotationsModelMetadataProvider类型,并且重写了CreateMetadata()的方法,在CreateMetadata()方法中会根据参数attributes中的特性信息来对Model元数据各种属性来操作赋值。这个会在下面说到,代码1-1中并没有对attributes参数这些来进行解析,而只是实例化了一个Model元数据类型(DataAnnotationsModelMetadata继承自ModelMetadata)用来返回。这样定义好了过后系统并不会调用我们自定义的实现,而是需要在项目启动的时候就添加到系统上下文中,我们就在Global.asax文件中的MvcApplication类型里的Application_Start()方法中来添加示例代码1-2.

代码1-2

ModelMetadataProviders.Current=newMyCustomModelMetadataProvider();

这样定义过后,系统框架在执行的时候就会调用我们的自定义实现了,还可以使用前面篇幅的示例来直接运行,什么结果我没试过不过肯定是不会有什么特殊效果,真正的目的不在这,而是在CreateMetadata()方法的入口处设上断点(图1)然后我们再次按F5执行程序,程序又会执行到我们自定义实现的CreateMetadata()方法。

图1

按照上面做的意义何在呢?这样做的意义在于在每次断点进来的时候,我们可以打开调试的即时窗口,并且输入CreateMetadata()方法参数的modelType来查看当前所要生成的Model元数据对应的类型或者是属性,也便于我们自己去更深入的学习。还有一个意思就是证明了我上篇所说的那样生成的过程。

下面我们来看一下系统默认提供的DataAnnotationsModelMetadataProvider类型中是怎么对Model元数据进行操作的,先看一下默认的实现代码,

代码1-3

protectedoverrideModelMetadataCreateMetadata(IEnumerable<Attribute>attributes,TypecontainerType,Func<object>modelAccessor,TypemodelType,stringpropertyName){List<Attribute>attributeList=newList<Attribute>(attributes);DisplayColumnAttributedisplayColumnAttribute=attributeList.OfType<DisplayColumnAttribute>().FirstOrDefault();DataAnnotationsModelMetadataresult=newDataAnnotationsModelMetadata(this,containerType,modelAccessor,modelType,propertyName,displayColumnAttribute);//Do[HiddenInput]before[UIHint],soyoucanoverridethetemplatehintHiddenInputAttributehiddenInputAttribute=attributeList.OfType<HiddenInputAttribute>().FirstOrDefault();if(hiddenInputAttribute!=null){result.TemplateHint="HiddenInput";result.HideSurroundingHtml=!hiddenInputAttribute.DisplayValue;}//Weprefer[UIHint("...",PresentationLayer="MVC")]butwillfallbackto[UIHint("...")]IEnumerable<UIHintAttribute>uiHintAttributes=attributeList.OfType<UIHintAttribute>();UIHintAttributeuiHintAttribute=uiHintAttributes.FirstOrDefault(a=>String.Equals(a.PresentationLayer,"MVC",StringComparison.OrdinalIgnoreCase))??uiHintAttributes.FirstOrDefault(a=>String.IsNullOrEmpty(a.PresentationLayer));if(uiHintAttribute!=null){result.TemplateHint=uiHintAttribute.UIHint;}EditableAttributeeditable=attributes.OfType<EditableAttribute>().FirstOrDefault();if(editable!=null){result.IsReadOnly=!editable.AllowEdit;}else{ReadOnlyAttributereadOnlyAttribute=attributeList.OfType<ReadOnlyAttribute>().FirstOrDefault();if(readOnlyAttribute!=null){result.IsReadOnly=readOnlyAttribute.IsReadOnly;}}DataTypeAttributedataTypeAttribute=attributeList.OfType<DataTypeAttribute>().FirstOrDefault();DisplayFormatAttributedisplayFormatAttribute=attributeList.OfType<DisplayFormatAttribute>().FirstOrDefault();//SetFromDataTypeAndDisplayAttributes(result,dataTypeAttribute,displayFormatAttribute);ScaffoldColumnAttributescaffoldColumnAttribute=attributeList.OfType<ScaffoldColumnAttribute>().FirstOrDefault();if(scaffoldColumnAttribute!=null){result.ShowForDisplay=result.ShowForEdit=scaffoldColumnAttribute.Scaffold;}DisplayAttributedisplay=attributes.OfType<DisplayAttribute>().FirstOrDefault();stringname=null;if(display!=null){result.Description=display.GetDescription();result.ShortDisplayName=display.GetShortName();result.Watermark=display.GetPrompt();result.Order=display.GetOrder()??ModelMetadata.DefaultOrder;name=display.GetName();}if(name!=null){result.DisplayName=name;}else{DisplayNameAttributedisplayNameAttribute=attributeList.OfType<DisplayNameAttribute>().FirstOrDefault();if(displayNameAttribute!=null){result.DisplayName=displayNameAttribute.DisplayName;}}RequiredAttributerequiredAttribute=attributeList.OfType<RequiredAttribute>().FirstOrDefault();if(requiredAttribute!=null){result.IsRequired=true;}returnresult;}

在代码1-3中,我们看到首先会根据参数attributes转换为Attribute集合类型的attributeList变量,然后就是在此集合中搜寻第一个DisplayColumnAttribute类型的特性,暂且先不说这个特性类型是干什么的,因为我现在也不太明白。

然后就是根据CreateMetadata()方法中的参数实例化一个DataAnnotationsModelMetadata类型的元数据,这个类型上面说过了。继续往下看,然后就到了从attributeList变量获取第一个HiddenInputAttribute类型的特性实例,在判断不为空后,对Model元数据DataAnnotationsModelMetadata类型变量result的两个属性开始赋值(下文中对Model元数据DataAnnotationsModelMetadata类型变量result统称叫result),首先第一个是Model元数据的TemplateHint属性,这个属性表示着这个Model元数据所表示的对象要使用哪个视图模板来生成Html代码(视图模板的内容这个系列的后面篇幅会有讲解,到时候再回头来看一下,学习嘛感觉就是一个迭代的过程)。然后是HideSurroundingHtml属性的赋值,对应的是HiddenInputAttribute类型的DisplayValue值,HiddenInputAttribute类型表示的是是否将属性或者字段值显示为隐藏的Input元素,如果我们这样写的话[HiddenInput(DisplayValue = false)],HideSurroundingHtml属性值则为true,代表的意思就是使用关联的Html元素来呈现对象模型,意思就是用HiddenInputAttribute类型所关联隐藏输入域来呈现我们所指定的属性或者字段。这里可能有点绕,不过不妨碍,下个篇幅会讲示例用的效果。

切回主题继续讲,下面则是从attributeList中获取UIHintAttribute类型的集合,并且经过一番判断获取一个UIHintAttribute类型的实例,并且还是赋值到TemplateHint属性(上面说过),这里就覆盖掉了,在我们使用默认的Model元数据提供程序的时候就要注意这些了,再继续往下看。

从attributeList中获取第一个EditableAttribute类型的实例,并且根据EditableAttribute类型实例中的AllowEdit属性值来设置result的IsReadOnly属性值,代表着指示这个模型是否只读,EditableAttribute类型指示模型是否可编辑的意思和下面的ReadOnlyAttribute类型很像,只不过同样是实现只读效果两个类型使用中设置的属性值是相反的。

同样是从attributeList获取符合类型条件的第一个DataTypeAttribute类型实例,还有个是DisplayFormatAttribute类型实例,这里会调用默认的提供程序里的另一个函数,在此就不做多的介绍了,我就稍微的说一下就行了。为什么把这两个放一起呢?因为他们都是对指定的模型输出格式的设置有关。

ScaffoldColumnAttribute类型实例表示着是否使用基架(模板视图辅助器的一种,EditorForModel属于其中之一),当某项属性上使用了这个特性类的时候,在使用基架的时候会直接跳过这项属性,在生成的页面中也不会发现这项属性。(遭到了嫌弃)

同样的DisplayAttribute类型的实例也是从attributeList获取符合类型条件的第一个,DisplayAttribute类型实例里有个Name属性会被设置到result的DisplayName属性,这个属性的意思就是指定的模型显示到页面的值。而DisplayNameAttribute类型实例的意思和DisplayAttribute类型的相近,只不过DisplayNameAttribute类型可以用于类类型,转定义我们一看便知。

最后对于RequiredAttribute类型实例的意思会在Model验证篇幅中说明。