[ASP.NET MVC] Model Binding With NameValueCollectionValueProvider

范例下载

范例程序代码：点此下载

问题情景

一般Web网站，都是以HTTP Request做为数据输入、HTTP Response做为数据输出，来完成一个网页要求响应的工作流程。

而ASP.NET MVC所建构的网站，在收到HTTP Request封包之后，会依照HTTP Request封包的Request URL内容，来选择对应的Controller以及Action，并且透过Model Binding机制来将HTTP Request封包剖析成为Action的函式参数。最后ASP.NET MVC会使用这些函式参数来执行Action函式，并且依照Action执行结果以及对应的View内容，来产生HTTP Response封包回传给浏览器，藉此完成HTTP Request输入、HTTP Response输出的工作流程。

本篇文章说明HTTP Request封包内容，如何被ASP.NET MVC的Model Binding机制使用，并且剖析成为Action的函式参数，为自己留个纪录也希望能帮助到有需要的开发人员。

数据源

HTTP Request封包内容，如何被ASP.NET MVC的Model Binding机制使用，并且剖析成为Action的函式参数；这一连串的工作流程，可以从用户点击浏览器页面中Sumit按钮来开始说明。

下列范例是一个HTML网页，这个网页中的Form窗体包含许多排版卷标、两个Text卷标以及一个 Submit标签。其中用来提供用户输入数据的两个Text卷标，名称分别为companyId及productId。

<form action="/Receive/Echo_Multi_DataTypeArgument/" method="post">

    CompanyId : <input type="text" name="companyId" value="AAAAA" /><br />

    <br />

    ProductId : <input type="text" name="productId" value="BBBBB" /><br />

    <br />

    <input type="submit" value="Submit" />

    <br />

</form>

当用户输入数据完毕之后，可使用鼠标点击页面上的Submit按钮，通知浏览器将Form窗体中的内容，封装成为HTTP Request封包来传送给Web服务器。

在这个阶段，浏览器会将Form窗体中输入卷标的卷标名称、卷标内容，以Name-Value的方式编码成为一个数据字符串。接着依照Form窗体上所定义的Method模式，来将这个数据字符串封装成为HTTP Request封包。

companyId=AAAAA&productId=BBBBB

当Method模式定义为Post的时候，浏览器会将HTTP Request封包的Content-Type内容定义为application/x-www-form-urlencoded，并且将数据字符串设定为HTTP Request封包的Form Data内容。

<form action="/Receive/Echo_Multi_DataTypeArgument/" method="post">

    CompanyId : <input type="text" name="companyId" value="AAAAA" /><br />

    <br />

    ProductId : <input type="text" name="productId" value="BBBBB" /><br />

    <br />

    <input type="submit" value="Submit" />

    <br />

</form>

当Method模式定义为Get的时候，浏览器会将数据字符串设定为HTTP Request封包的Query String内容。

<form action="/Receive/Echo_Multi_DataTypeArgument/" method="get">

    CompanyId : <input type="text" name="companyId" value="AAAAA" /><br />

    <br />

    ProductId : <input type="text" name="productId" value="BBBBB" /><br />

    <br />

    <input type="submit" value="Submit" />

    <br />

</form>

服务器端的ASP.NET在收到HTTP Request封包之后，会撷取HTTP Request封包所定义的Form Data内容、Query String内容，以Name-Value的方式译码成为数据内容，并且使用这些数据内容建立为对应的NameValueCollection对象。

Form Data内容以Name-Value的方式译码成为数据内容之后，服务器端的ASP.NET会将数据内容建立为NameValueCollection对象，并且定义为System.Web.HttpContext.Current.Request.Form属性的内容。
Query String内容以Name-Value的方式译码成为数据内容之后，服务器端的ASP.NET会将数据内容建立为NameValueCollection对象，并且定义为System.Web.HttpContext.Current.Request.QueryString属性的内容。

而这两个NameValueCollection物件，在ASP.NET MVC中会被统一封装成为NameValueCollectionValueProvider对象，来做为Model Binding机制的数据源。

资料系结

在ASP.NET MVC中使用NameValueCollectionValueProvider对象，做为Model Binding机制的数据源时,会依照下列规则来剖析NameValueCollectionValueProvider所提供的Name-Value数据内容，并且生成对应的Action函式参数。(为了降低学习曲线，空白前缀、数组跳号...等等进阶规则暂先排除。)

单一值类型

当Action函式，包含一个值类型的函式参数时。Model Binding核心会依照这个函式参数的「参数名称」作为Key数据，来从NameValueCollectionValueProvider对象中取得对应的Value数据，并且尝试将Value资料转型为函式参数的「参数型别」,当成功转型之后就生成一个「函式参数」。后续ASP.NET MVC就会使用这个函式参数执行Action函式，并且完成接续的工作流程来产生HTTP Response封包回传给浏览器。

<form action="/Receive/Echo_Single_DataTypeArgument/" method="post">

    CompanyId : <input type="text" name="companyId" value="AAAAA" /><br />

    <br />

    <input type="submit" value="Submit" />

    <br />

</form>

多个值类型

当Action函式，包含多个值类型的函式参数时。Model Binding核心透过生成单一值类型的流程，依序生成每个对应「参数名称」的函式参数。后续ASP.NET MVC就会使用这些函式参数执行Action函式，并且完成接续的工作流程来产生HTTP Response封包回传给浏览器。

<form action="/Receive/Echo_Multi_DataTypeArgument/" method="post">

    CompanyId : <input type="text" name="companyId" value="AAAAA" /><br />

    <br />

    ProductId : <input type="text" name="productId" value="BBBBB" /><br />

    <br />

    <input type="submit" value="Submit" />

    <br />

</form>

值类型集合

当Action函式，包含值类型集合的函式参数时。Model Binding核心会依照这个函式参数的「参数名称」作为Prefix数据，来从NameValueCollectionValueProvider对象中取得所有符合「Prefix数据[索引]」格式的一组Key数据。接着Model Binding核心会先依照函式参数的「参数型别」建立一个集合，并且透过生成单一值类型的流程，依序生成每个对应「Key数据」的数据，来做为这个集合的项目。最后ASP.NET MVC就会使用这个集合作为函式参数来执行Action函式，并且完成接续的工作流程来产生HTTP Response封包回传给浏览器。

<form action="/Receive/Echo_Array_DataTypeArgument/" method="post">

    CompanyIdArray[0] : <input type="text" name="companyIdArray[0]" value="AAAAA" /><br />

    CompanyIdArray[1] : <input type="text" name="companyIdArray[1]" value="BBBBB" /><br />

    <br />

    ProductIdArray[0] : <input type="text" name="productIdArray[0]" value="CCCCC" /><br />

    ProductIdArray[1] : <input type="text" name="productIdArray[1]" value="DDDDD" /><br />

    <br />

    <input type="submit" value="Submit" />

    <br />

</form>

单一参考型别

当Action函式，包含一个参考型别的函式参数时。Model Binding核心会先依照函式参数的「参数型别」建立一个对象，并且依序将函式参数的「参数名称」、对象的「属性名称」，组合成为「参数名称.属性名称」格式的Key数据，接着透过生成单一值类型的流程，依序生成每个对应「Key数据」的对象属性。最后ASP.NET MVC就会使用这个对象作为函式参数来执行Action函式，并且完成接续的工作流程来产生HTTP Response封包回传给浏览器。

<form action="/Receive/Echo_Single_ObjectTypeArgument/" method="post">

    Company.Id = <input type="text" name="company.Id" value="AAAAA" /><br />

    Company.Name = <input type="text" name="company.Name" value="BBBBB" /><br />

    Company.Address = <input type="text" name="company.Address" value="12345" /><br />

    <br />

    <input type="submit" value="Submit" />

    <br />

</form>

多个参考型别

当Action函式，包含多个参考型别的函式参数时。Model Binding核心透过生成单一参考型别的流程，依序生成每个对应「参数名称」的函式参数。后续ASP.NET MVC就会使用这些函式参数执行Action函式，并且完成接续的工作流程来产生HTTP Response封包回传给浏览器。

<form action="/Receive/Echo_Multi_ObjectTypeArgument/" method="post">

    Company.Id = <input type="text" name="company.Id" value="AAAAA" /><br />

    Company.Name = <input type="text" name="company.Name" value="BBBBB" /><br />

    Company.Address = <input type="text" name="company.Address" value="12345" /><br />

    <br />

    Product.Id = <input type="text" name="product.Id" value="CCCCC" /><br />

    Pproduct.Name = <input type="text" name="product.Name" value="DDDDD" /><br />

    Product.Price = <input type="text" name="product.Price" value="67890" /><br />

    <br />

    <input type="submit" value="Submit" />

    <br />

</form>

参考型别集合

当Action函式，包含参考型别集合的函式参数时。Model Binding核心会依照这个函式参数的「参数名称」作为Prefix数据，来从NameValueCollectionValueProvider对象中取得所有符合「Prefix数据[索引]」格式的一组Key数据。接着Model Binding核心会先依照函式参数的「参数型别」建立一个集合，并且透过生成单一参考型别的流程，依序生成每个对应「Key数据」的数据，来做为这个集合的项目。最后ASP.NET MVC就会使用这个集合作为函式参数来执行Action函式，并且完成接续的工作流程来产生HTTP Response封包回传给浏览器。

<form action="/Receive/Echo_Array_ObjectTypeArgument/" method="post">

    CompanyArray[0].Id = <input type="text" name="companyArray[0].Id" value="AAAAA" /><br />

    CompanyArray[0].Name = <input type="text" name="companyArray[0].Name" value="BBBBB" /><br />

    CompanyArray[0].Address = <input type="text" name="companyArray[0].Address" value="12345" /><br />

    CompanyArray[1].Id = <input type="text" name="companyArray[1].Id" value="CCCCC" /><br />

    CompanyArray[1].Name = <input type="text" name="companyArray[1].Name" value="DDDDD" /><br />

    CompanyArray[1].Address = <input type="text" name="companyArray[1].Address" value="67890" /><br />

    <br />

    ProductArray[0].Id = <input type="text" name="productArray[0].Id" value="EEEEE" /><br />

    ProductArray[0].Name = <input type="text" name="productArray[0].Name" value="FFFFF" /><br />

    ProductArray[0].Price = <input type="text" name="productArray[0].Price" value="54321" /><br />

    ProductArray[1].Id = <input type="text" name="productArray[1].Id" value="GGGGG" /><br />

    ProductArray[1].Name = <input type="text" name="productArray[1].Name" value="HHHHH" /><br />

    ProductArray[1].Price = <input type="text" name="productArray[1].Price" value="09876" /><br />

    <br />

    <input type="submit" value="Submit" />

    <br />

</form>

多个混合型别

当Action函式，包含多个值类型、参考型别的函式参数时。Model Binding核心会依需透过生成单一值类型、生成单一参考型别的流程，依序生成每个对应「参数名称」的函式参数。后续ASP.NET MVC就会使用这些函式参数执行Action函式，并且完成接续的工作流程来产生HTTP Response封包回传给浏览器。

<form action="/Receive/Echo_Multi_MixTypeArgument/" method="post">

    CompanyId : <input type="text" name="companyId" value="AAAAA" /><br />

    <br />

    Product.Id = <input type="text" name="product.Id" value="BBBBB" /><br />

    Product.Name = <input type="text" name="product.Name" value="CCCCC" /><br />

    Product.Price = <input type="text" name="product.Price" value="12345" /><br />

    <br />

    <input type="submit" value="Submit" />

    <br />

</form>

混合型别集合

当Action函式，包含多个值类型集合、参考型别集合的函式参数时。Model Binding核心会依需透过生成值类型集合、生成参考型别集合的流程，依序生成每个对应「参数名称」的函式参数。后续ASP.NET MVC就会使用这些函式参数执行Action函式，并且完成接续的工作流程来产生HTTP Response封包回传给浏览器。

<form action="/Receive/Echo_Array_MixTypeArgument/" method="post">

    CompanyIdArray[0] : <input type="text" name="companyIdArray[0]" value="AAAAA" /><br />

    CompanyIdArray[1] : <input type="text" name="companyIdArray[1]" value="BBBBB" /><br />

    <br />

    ProductArray[0].Id = <input type="text" name="productArray[0].Id" value="CCCCC" /><br />

    ProductArray[0].Name = <input type="text" name="productArray[0].Name" value="DDDDD" /><br />

    ProductArray[0].Price = <input type="text" name="productArray[0].Price" value="12345" /><br />

    ProductArray[1].Id = <input type="text" name="productArray[1].Id" value="EEEEE" /><br />

    ProductArray[1].Name = <input type="text" name="productArray[1].Name" value="FFFFF" /><br />

    ProductArray[1].Price = <input type="text" name="productArray[1].Price" value="67890" /><br />

    <br />

    <input type="submit" value="Submit" />

    <br />

</form>

参考数据