OStack程序员社区-中国程序员成长平台 › 门户 › 编程› ASP.NET›ASP.NET编程经验

ASP.NET MVC以ValueProvider为核心的值提供系统: NameValueCollectionValueProvider ...

原作者: [db:作者] 来自: [db:来源] 收藏邀请

在进行Model绑定过程中，需要根据基于Action方法参数的绑定上下文从请求数据中提取相应的数据以提供相应的数据。具体来说，Model绑定的数据具有多个来源，可能来源于Post的表单或者JSON字符串，或者来源于当前的路由数据，也可能来源于请求地址的插叙字符串。ASP.NET MVC将这种基于不同数据来源的数据获取/提供机制实现在一个叫做ValueProvider的组件中。[本文已经同步到《How ASP.NET MVC Works?》中]

目录
一、IValueProvider与ValueProviderResult
二、NameValueCollectionValueProvider
三、两种前缀形式
四、实例演示：返回指定前缀的Key
五、FormValueProvider与QueryStringValueProvider

一般来讲，一个ValueProvider采用的数据源是一个字典类型的数据结构，我们通过它从这个字典中获取一个Key与当前绑定上下文匹配的值。ValueProvider实现了具有如下定义的接口IValueProvider，GetValue方法根据指定的Key从数据源中获取对应的值对象，这个Key是基于当前绑定上下文的。这个Key和存在于数据源中对应数据条目的Key可能并非完全一致，后者可能在前者基础上添加相应的前缀，而ContainsPrefix方法用于判断数据源字典的Key是否具有指定的前缀。

interface IValueProvider

   2: {

string prefix);

string key);

   5: }

IValueProvider的GetValue返回的是一个ValueProviderResult对象，我们可以将ValueProviderResult看成是对ValueProvider提供对象的封装。如下面的代码片断所示，ValueProviderResult具有三个只读属性，其中RawValue表示原始的值对象。而AttemptedValue表示以值对象的字符串表示，该属性主要用于显示。

   1: [Serializable]

class ValueProviderResult

   3: {

string attemptedValue, CultureInfo culture);

object ConvertTo(Type type);

object ConvertTo(Type type, CultureInfo culture);

7:

string AttemptedValue { get; }

public CultureInfo Culture { get; }

object RawValue { get; }

  11: }

ValueProviderResult提供了两个ConvertTo方法重载以实现向指定目标类型的转换。某些类型的格式化行为依赖于相应的语言文化（比如时间、日期和货币等），而这个辅助格式湖的语言文化信息通过Culture属性表示。其中第一个ValueProviderResult方法重载通过属性Culture表示的语言文化进行类型转化。

二、NameValueCollectionValueProvider

前面已经说过，Model数据源一般具有类似于字典的结构，而NameValueCollection可以表示为Key不具有唯一性的字典，将NameValueCollection对象作为数据源的ValueProvider通过具有如下定义的NameValueCollectionValueProvider类型表示。表示数据源的NameValueCollection对象在构造函数中指定，构造函数的另一个CultureInfo类型的参数表示服务于数据转换的语言文化信息。

class NameValueCollectionValueProvider : IUnvalidatedValueProvider, IEnumerableValueProvider, IValueProvider

   2: {

//其他成员

public NameValueCollectionValueProvider(NameValueCollection collection,  CultureInfo culture);

5:

string prefix);

string prefix);

string key);

bool skipValidation);

  10: }

11:

interface IEnumerableValueProvider : IValueProvider

  13: {

string prefix);

  15: }

16:

interface IUnvalidatedValueProvider : IValueProvider

  18: {

bool skipValidation);

  20: }

从上面的代码片断我们可以看到，除了IValueProvider接口，NameValueCollectionValueProvider还实现了IEnumerableValueProvider和IUnvalidatedValueProvider两个接口。顾名思义，IEnumerableValueProvider主要用于针对目标类型为集合的数据提供，方法GetKeysFromPrefix以一字典的形式返回具有指定前缀的Key。在默认的情况下，在进行数据提供的同时会对数据进行验证，而IUnvalidatedValueProvider接口提供了一个额外的GetValue方法是我们可以忽略对数据的验证。

三、两种前缀形式

辅助实现Model绑定的数据提供机制是以Model元数据为基础的，通过《初识Model元数据》我们知道用于描述一个复杂数据类型的Model元数据具有一个树型的层次化结构，而作为数据源的NameValueCollection却是一个“扁平”的结构，两者之前的匹配通过前缀来表示。举个简单的例子，假设通过NameValueCollectionValueProvider提供对象的目标类型为具有如下定义的Contact。表示联系地址的属性是一个复杂类型Address，所以针对Contact类型的Model元数据树具有两个层级。

class Contact

   2: {

string Name { get; set; }

string PhoneNo { get; set; }

string EmailAddress { get; set; }

public Address Address { get; set; }

   7: }

class Address

   9: {

string Province { get; set; }

string City { get; set; }

string District { get; set; }

string Street { get; set; }

  14: }

由于NameValueCollection中每个元数据的值都是一个字符串，所以不可能单独表示一个复杂类型，复杂类型对象需要通过多个元素值组装而成。如果通过NameValueCollectionValueProvider来初始化一个完整的Contact对象，表示数据源的NameValueCollection至少需要包含7个元素，分别针对Contact除Address属性的三个属性值和作为Address的四个属性值，两类元素在NameValueCollection中通过基于属性的前缀来区分，具体的结构如下所示。

   1: Name:Foo

   2: PhoneNo:123456789

   3: EmailAddress:Foomail.com

   4: Address.Province: 江苏

   5: Address.City: 苏州

   6: Address.District: 工业园区

   7: Address.Street: 星湖街328号

将点号(.)作为分隔符的前缀除了表示基于属性的层级关系之外，还可以用于数据筛选。如下面的代码片断所示，我们在ContactController中定义了一个用于添加联系人的AddContacts，它具有两个Contact类型的参数foo和bar，表示添加的两个不同的联系人。

class ContactController

   2: {

void AddContacts(Contact foo, Contact bar)

   4:     {

//省略实现

   6:     }

   7: }

如果我们采用NameValueCollectionValueProvider来提供作为AddContacts方法参数的两个Contact对象，保存在NameValueCollection的数据元素必须能够与它们进行合理映射。一般情况下这可以通过针对参数名的前缀来实现，具体数据结构如下所示。

   1: foo.Name：Foo

   2: foo.PhoneNo：123456789

   3: foo.EmailAddress：[email protected]

   4: foo.Address.Province: 江苏

   5: foo.Address.City: 苏州

   6: foo.Address.District: 工业园区

   7: foo.Address.Street: 星湖街328号

8:

   9: bar.Name：Bar

  10: bar.PhoneNo：987654321

  11: bar.EmailAddress：[email protected]

  12: bar.Address.Province: 江苏

  13: bar.Address.City: 苏州

  14: bar.Address.District: 工业园区

  15: bar.Address.Street: 机场路328号

除了采用基于“.”的前缀之外，数组或者集合类型的数据源元素可以采用基于“索引”的前缀，这样的前缀通过方括号“[]”表示，如下的数据结构就可以表示包含两个元素的Contact数组或者集合。

   1: [0].Name：Foo

   2: [0].PhoneNo：123456789

   3: [0].EmailAddress：[email protected]

   4: ...

   5: [1].Name：Bar

   6: [1].PhoneNo：987654321

   7: [1].EmailAddress：[email protected]

   8: ...

9:

除了采用数字作为索引之前，我们还可以按照如下的方式通过文字作为索引。针对两种不同形式的索引的Model绑定机制有所不同，我们会在后续的部分予以讲述。

   1: [foo].Name：Foo

   2: [foo].PhoneNo：123456789

   3: [foo].EmailAddress：[email protected]

   4: ...

   5: [bar].Name：Bar

   6: [bar].PhoneNo：987654321

   7: [bar].EmailAddress：[email protected]

   8: ...

如果数据源元素针对不同的目标集合对象，同样需要采用相应的前缀予以区分，相面的数据结构可以看成是针对两个Contact列表（first和second）的数据源。

   1: first[0].Name：Zhao

   2: first[0].PhoneNo：12

   3: first[0].EmailAddress：zhao @gmail.com

   4: ...

   5: first[1].Name：Qian

   6: first[1].PhoneNo：34

   7: first[1].EmailAddress：[email protected]

   8: ...

9:

  10: second[0].Name：Sun

  11: second[0].PhoneNo：56

  12: second[0].EmailAddress：[email protected]

  13: ...

  14: second[1].Name：Li

  15: second[1].PhoneNo：78

  16: second[1].EmailAddress：[email protected]

四、实例演示：返回指定前缀的Key

在了解两种不同类型的前缀之后，我们来关注一下NameValueCollectionValueProvider实现的GetKeysFromPrefix方法。从该方法的定义可以看出它返回的是一个IDictionary<string, string>对象，但是这个对象具有怎样的数据呢？我们为此来进行一个实例演示。在通过Visual Studio的ASP.NET MVC项目模板创建的空Web应用中，我们定义了如下一个默认的HomeController。在Action方法Index中我们创建了一个NameValueCollection对象，并针对它创建一个NameValueCollectionValueProvider．

class HomeController : Controller

   2: {

void Index()

   4:     {

new NameValueCollection();

);

);

);

);

);

);

);

new NameValueCollectionValueProvider(datasource, CultureInfo.InvariantCulture);

14:

);

);

in keyDictionary)

  18:         {

, item.Key, item.Value));

  20:         }

21:

);

);

in keyDictionary)

  25:         {

, item.Key, item.Value));

  27:         }

  28:     }

  29: }

通过上面的代码片断可以看出，作为NameValueCollectionValueProvider的数据元素是按照Contact类型的属性定义来添加的。我们分别将“foo”和“foo.Address”作为前缀返回以此作为前缀的Key。运行该程序后会在浏览器上得到如下的输出结果。我们可以看到对于针对指定前缀返回的字典对象，其Key和Value的不同之处在于前者没有包含指定的前缀而后者包含。此外，字典对象包含的元素全部处于同一级别，将“foo”指定为前缀时返回的元素针对于Contact的四个属性。虽然NameValueCollection中并不包含一个名为“foo.Address”的元素，但是依然会将其单独作为以“foo”为前缀的Key。

   1: foo

   2: Name            : foo.Name

   3: PhoneNo         : foo.PhoneNo

   4: EmailAddress    : foo.EmailAddress

   5: Address         : foo.Address

6:

   7: foo.Address

   8: Province        : foo.Address.Province

   9: City            : foo.Address.City

  10: District        : foo.Address.District

  11: Street          : foo.Address.Street

接下来我们采用相应的方式来演示基于索引的前缀，为此我们将HomeController的Index反方法进行了如下的改写。作为数据源的NameValueCollection对象针对一个包含两个元素的Contact集合，前缀“first”可以作为集合对象的名称。

该文章已有0人参与评论

请发表评论

全部评论

专题导读

More+

asp.net图片上传与显示发布时间：2022-07-10

asp.net使用Substring截取字符串发布时间：2022-07-10

139-2527-9053

在线客服（服务时间 9:00～18:00）

在线QQ客服

地址：深圳市南山区西丽大学城创智工业园

电邮：jeky_zhao#qq.com

移动电话：139-2527-9053

客服电话

电子邮件

ASP.NET MVC以ValueProvider为核心的值提供系统: NameValueCollectionValueProvider ...

二、NameValueCollectionValueProvider

三、两种前缀形式

四、实例演示：返回指定前缀的Key

请发表评论

全部评论

上一篇：

下一篇：

关于我们

产品与服务

解决方案

139-2527-9053