MVC 元模型元数据ViewData.ModelMetadata

小渣渣

模型元数据ModelMetaData是MVC中很重要的概念,它包括但不仅限于 模型的类型，模型包含了哪些属性，属性都是什么类型的，属性上都有什么特性。

ASP.NET MVC3.0 提供了默认的模型元数据 DataAnnotationsModelMetadata 继承自ModelMetadata(另外系统提供了默认的模型元数据提供器DataAnnotationsModelMetadataProvider)

public class DataAnnotationsModelMetadata : ModelMetadata

它的构造函数如下

public DataAnnotationsModelMetadata(DataAnnotationsModelMetadataProvider provider, Type containerType, Func modelAccessor, Type modelType, string propertyName, DisplayColumnAttribute displayColumnAttribute);


DataAnnotationsModelMetadata类有常用的几个属性

DisplayName 显示名称,DisplayFormatString格式字符串

TemplateHint 获取一个值选择使用哪个模版


对于DisplayName ，LabelFor<TModel, TValue> 方法中使用此属性来生成标签文本.  意思就是一旦我们的model上有定义了DispalyName特性，那么view中使用html.editForModel()方法就会自动为model的这个属性显示出label标签"  <label for="username">名称</label></

  

[Display( Name="名称",Order=2)]   //order属性改变在html页面中的排列顺序
  public string username { get; set; }




html源代码：

1. <div class="editor-label"><label for="username">名称</label></div>
   
2. <div class="editor-field"><input class="text-box single-line" data-val="true" data-val-maxwords="名称 has too many words" data-val-maxwords-wordcount="2" data-val-required="名称 字段是必需的。" id="username" name="username" type="text" value=""> <span class="field-validation-valid" data-valmsg-for="username" data-valmsg-replace="true"></span></div>

复制代码

属性username上用的Display特性就是System.ComponentModel.DataAnnotations.DisplayAttribute类提供一个通用特性，使您可以为实体分部类的类型和成员指定可本地化的字符串


另外还有一些特性来自System.Web.MVC 和 System.ComponentModel.DataAnnotations，名称凡类似 XXXXAttribute的都为特性类，都有特定的使用范围，有的限制模型属性，有的限制Contrller,有的限制Action等等。


下面列举了这2个命名空间下，内置的而且常用的特性类

1)System.Web.MVC空间下的

AcceptVerbsAttribute，ActionFilterAttribute，ActionNameAttribute，AsyncTimeoutAttribute，AuthorizeAttribute，BindAttribute，

HiddenInputAttribute

ActionFilterAttribute  表示所有操作-筛选器特性的基类

HttpDeleteAttribute 类，表示一个特性，该特性用于限制操作方法，以便该方法仅处理 HTTP DELETE 请求

HttpGetAttribute，HttpPostAttribute 表示特性，用于限制操作方法，仅限处理PUT请求

HttpPutAttribute  表示一个特性，该特性用于限制操作方法，以便该方法仅处理 HTTP PUT 请求。


例：ActionNameAttribute 指定action的实际actionname，用法如下

[ActionName()]

public ActionResult  Index()


例:HiddenInputAttribute类，表示一个特性，该特性用于指示是否应将属性值或字段值呈现为隐藏 input 元素

小渣渣

ModelMetadata

1. // 摘要:
   
2.     //     为数据模型的公共元数据、System.Web.Mvc.ModelMetadataProvider 类和 System.Web.Mvc.ModelValidator
   
3.     //     类提供容器。
   
4.     public class ModelMetadata
   
5.     {
   
6.         // 摘要:
   
7.         //     默认顺序值 10000。
   
8.         public const int DefaultOrder = 10000;
   
9. 
   
10.         // 摘要:
    
11.         //     初始化 System.Web.Mvc.ModelMetadata 类的新实例。
    
12.         //
    
13.         // 参数:
    
14.         //   provider:
    
15.         //     提供程序。
    
16.         //
    
17.         //   containerType:
    
18.         //     容器的类型。
    
19.         //
    
20.         //   modelAccessor:
    
21.         //     模型访问器。
    
22.         //
    
23.         //   modelType:
    
24.         //     模型的类型。
    
25.         //
    
26.         //   propertyName:
    
27.         //     模型的名称。
    
28.         public ModelMetadata(ModelMetadataProvider provider, Type containerType, Func<object> modelAccessor, Type modelType, string propertyName);
    
29. 
    
30.         // 摘要:
    
31.         //     获取包含有关模型的其他元数据的字典。
    
32.         //
    
33.         // 返回结果:
    
34.         //     包含有关模型的其他元数据的字典。
    
35.         public virtual Dictionary<string, object> AdditionalValues { get; }
    
36.         //
    
37.         // 摘要:
    
38.         //     获取或设置模型的容器的类型。
    
39.         //
    
40.         // 返回结果:
    
41.         //     模型的容器的类型。
    
42.         public Type ContainerType { get; }
    
43.         //
    
44.         // 摘要:
    
45.         //     获取或设置一个值，该值指示在窗体中回发的空字符串是否应转换为 null。
    
46.         //
    
47.         // 返回结果:
    
48.         //     如果在窗体中回发的空字符串应转换为 null，则为 true；否则为 false。默认值为 true。
    
49.         public virtual bool ConvertEmptyStringToNull { get; set; }
    
50.         //
    
51.         // 摘要:
    
52.         //     获取或设置有关数据类型的元信息。
    
53.         //
    
54.         // 返回结果:
    
55.         //     有关数据类型的元信息。
    
56.         public virtual string DataTypeName { get; set; }
    
57.         //
    
58.         // 摘要:
    
59.         //     获取或设置模型的说明。
    
60.         //
    
61.         // 返回结果:
    
62.         //     模型的说明。默认值为 null。
    
63.         public virtual string Descrip{过滤}tion { get; set; }
    
64.         //
    
65.         // 摘要:
    
66.         //     获取或设置模型的显示格式字符串。
    
67.         //
    
68.         // 返回结果:
    
69.         //     模型的显示格式字符串。
    
70.         public virtual string DisplayFormatString { get; set; }
    
71.         //
    
72.         // 摘要:
    
73.         //     获取或设置模型的显示名称。
    
74.         //
    
75.         // 返回结果:
    
76.         //     模型的显示名称。
    
77.         public virtual string DisplayName { get; set; }
    
78.         //
    
79.         // 摘要:
    
80.         //     获取或设置模型的编辑格式字符串。
    
81.         //
    
82.         // 返回结果:
    
83.         //     模型的编辑格式字符串。
    
84.         public virtual string EditFormatString { get; set; }
    
85.         //
    
86.         // 摘要:
    
87.         //     获取或设置一个值，该值指示是否应该使用关联的 HTML 元素呈现模型对象。
    
88.         //
    
89.         // 返回结果:
    
90.         //     如果包含模型对象的关联 HTML 元素应包含在该对象中，则为 true；否则为 false。
    
91.         public virtual bool HideSurroundingHtml { get; set; }
    
92.         //
    
93.         // 摘要:
    
94.         //     获取或设置一个值，该值指示模型是否为复杂类型。
    
95.         //
    
96.         // 返回结果:
    
97.         //     一个值，指示 MVC 框架是否将模型视为复杂类型。
    
98.         public virtual bool IsComplexType { get; }
    
99.         //
    
100.         // 摘要:
     
101.         //     获取一个值，该值指示类型是否可为 null。
     
102.         //
     
103.         // 返回结果:
     
104.         //     如果该类型可为 null，则为 true；否则为 false。
     
105.         public bool IsNullableValueType { get; }
     
106.         //
     
107.         // 摘要:
     
108.         //     获取或设置一个值，该值指示模型是否为只读。
     
109.         //
     
110.         // 返回结果:
     
111.         //     如果该模型为只读，则为 true；否则为 false。
     
112.         public virtual bool IsReadOnly { get; set; }
     
113.         //
     
114.         // 摘要:
     
115.         //     获取或设置一个值，该值指示模型是否为必需的。
     
116.         //
     
117.         // 返回结果:
     
118.         //     如果该模型是必需的，则为 true；否则为 false。
     
119.         public virtual bool IsRequired { get; set; }
     
120.         //
     
121.         // 摘要:
     
122.         //     获取模型的值。
     
123.         //
     
124.         // 返回结果:
     
125.         //     模型的值。有关 System.Web.Mvc.ModelMetadata 的更多信息，请参见 Brad Wilson 的博客上的文章 ASP.NET
     
126.         //     MVC 2 Templates, Part 2: ModelMetadata
     
127.         public object Model { get; set; }
     
128.         //
     
129.         // 摘要:
     
130.         //     获取模型的类型。
     
131.         //
     
132.         // 返回结果:
     
133.         //     模型的类型。
     
134.         public Type ModelType { get; }
     
135.         //
     
136.         // 摘要:
     
137.         //     获取或设置要为 null 值显示的字符串。
     
138.         //
     
139.         // 返回结果:
     
140.         //     要为 null 值显示的字符串。
     
141.         public virtual string NullDisplayText { get; set; }
     
142.         //
     
143.         // 摘要:
     
144.         //     获取或设置一个值，该值表示当前元数据的顺序。
     
145.         //
     
146.         // 返回结果:
     
147.         //     当前元数据的顺序值。
     
148.         public virtual int Order { get; set; }
     
149.         //
     
150.         // 摘要:
     
151.         //     获取模型元数据对象的集合，这些对象描述模型的属性。
     
152.         //
     
153.         // 返回结果:
     
154.         //     用于描述模型属性的模型元数据对象的集合。
     
155.         public virtual IEnumerable<ModelMetadata> Properties { get; }
     
156.         //
     
157.         // 摘要:
     
158.         //     获取属性名称。
     
159.         //
     
160.         // 返回结果:
     
161.         //     属性名称。
     
162.         public string PropertyName { get; }
     
163.         //
     
164.         // 摘要:
     
165.         //     获取或设置提供程序。
     
166.         //
     
167.         // 返回结果:
     
168.         //     提供程序。
     
169.         protected ModelMetadataProvider Provider { get; set; }
     
170.         //
     
171.         // 摘要:
     
172.         //     获取或设置一个值，该值指示是否启用请求验证。
     
173.         //
     
174.         // 返回结果:
     
175.         //     如果启用了请求验证，则为 true；否则为 false。
     
176.         public virtual bool RequestValidationEnabled { get; set; }
     
177.         //
     
178.         // 摘要:
     
179.         //     获取或设置短显示名称。
     
180.         //
     
181.         // 返回结果:
     
182.         //     短显示名称。
     
183.         public virtual string ShortDisplayName { get; set; }
     
184.         //
     
185.         // 摘要:
     
186.         //     获取或设置一个值，该值指示属性是否应显示在只读视图（如列表和详细信息视图）中。
     
187.         //
     
188.         // 返回结果:
     
189.         //     如果应在只读视图中显示模型，则为 true；否则为 false。
     
190.         public virtual bool ShowForDisplay { get; set; }
     
191.         //
     
192.         // 摘要:
     
193.         //     获取或设置一个值，该值指示是否应在可编辑视图中显示模型。
     
194.         //
     
195.         // 返回结果:
     
196.         //     如果应在可编辑视图中显示模型，则为 true；否则为 false。
     
197.         public virtual bool ShowForEdit { get; set; }
     
198.         //
     
199.         // 摘要:
     
200.         //     获取或设置模型的简单显示字符串。
     
201.         //
     
202.         // 返回结果:
     
203.         //     模型的简单显示字符串。
     
204.         public virtual string SimpleDisplayText { get; set; }
     
205.         //
     
206.         // 摘要:
     
207.         //     获取或设置一个提示，该提示建议要为此模型使用哪个模板。
     
208.         //
     
209.         // 返回结果:
     
210.         //     一个提示，建议要为此模型使用哪个模板。
     
211.         public virtual string TemplateHint { get; set; }
     
212.         //
     
213.         // 摘要:
     
214.         //     获取或设置可用作水印的值。
     
215.         //
     
216.         // 返回结果:
     
217.         //     水印。
     
218.         public virtual string Watermark { get; set; }
     
219. 
     
220.         // 摘要:
     
221.         //     从模型的 System.Linq.Expressions.Expression 参数返回元数据。
     
222.         //
     
223.         // 参数:
     
224.         //   expression:
     
225.         //     一个标识模型的表达式。
     
226.         //
     
227.         //   viewData:
     
228.         //     视图数据字典。
     
229.         //
     
230.         // 类型参数:
     
231.         //   TParameter:
     
232.         //     参数的类型。
     
233.         //
     
234.         //   TValue:
     
235.         //     值的类型。
     
236.         //
     
237.         // 返回结果:
     
238.         //     元数据。
     
239.         public static ModelMetadata FromLambdaExpression<TParameter, TValue>(Expression<Func<TParameter, TValue>> expression, ViewDataDictionary<TParameter> viewData);
     
240.         //
     
241.         // 摘要:
     
242.         //     从模型的表达式参数中获取元数据。
     
243.         //
     
244.         // 参数:
     
245.         //   expression:
     
246.         //     一个标识模型的表达式。
     
247.         //
     
248.         //   viewData:
     
249.         //     视图数据字典。
     
250.         //
     
251.         // 返回结果:
     
252.         //     模型的元数据。
     
253.         public static ModelMetadata FromStringExpression(string expression, ViewDataDictionary viewData);
     
254.         //
     
255.         // 摘要:
     
256.         //     获取模型的显示名称。
     
257.         //
     
258.         // 返回结果:
     
259.         //     模型的显示名称。
     
260.         public string GetDisplayName();
     
261.         //
     
262.         // 摘要:
     
263.         //     返回模型的简单说明。
     
264.         //
     
265.         // 返回结果:
     
266.         //     模型的简单说明。
     
267.         protected virtual string GetSimpleDisplayText();
     
268.         //
     
269.         // 摘要:
     
270.         //     获取模型的验证程序的列表。
     
271.         //
     
272.         // 参数:
     
273.         //   context:
     
274.         //     控制器上下文。
     
275.         //
     
276.         // 返回结果:
     
277.         //     模型的验证程序的列表。
     
278.         public virtual IEnumerable<ModelValidator> GetValidators(ControllerContext context);
     
279.     }

复制代码

小渣渣

1. internal virtual void RenderPartialInternal(string partialViewName, ViewDataDictionary viewData, object model, TextWriter writer, ViewEngineCollection viewEngineCollection)
   
2. {
   
3.         if (string.IsNullOrEmpty(partialViewName))
   
4.         {
   
5.                 throw new ArgumentException(MvcResources.Common_NullOrEmpty, "partialViewName");
   
6.         }
   
7.         ViewDataDictionary viewData2;
   
8.         if (model == null)
   
9.         {
   
10.                 if (viewData == null)
    
11.                 {
    
12.                         viewData2 = new ViewDataDictionary(this.ViewData);
    
13.                 }
    
14.                 else
    
15.                 {
    
16.                         viewData2 = new ViewDataDictionary(viewData);
    
17.                 }
    
18.         }
    
19.         else if (viewData == null)
    
20.         {
    
21.                 viewData2 = new ViewDataDictionary(model);
    
22.         }
    
23.         else
    
24.         {
    
25.                 viewData2 = new ViewDataDictionary(viewData)
    
26.                 {
    
27.                         Model = model
    
28.                 };
    
29.         }
    
30.         ViewContext viewContext = new ViewContext(this.ViewContext, this.ViewContext.View, viewData2, this.ViewContext.TempData, writer);
    
31.         IView view = HtmlHelper.FindPartialView(viewContext, partialViewName, viewEngineCollection);
    
32.         view.Render(viewContext, writer);
    
33. }
    

复制代码

ViewData获取属性代码：

ViewDataDictionary viewData2=new ViewDataDictionary(ViewData["Test"]);
viewData2.ModelMetadata.Properties;