ASP.NET MVC以ValueProvider為核心的值提供系統 二

DictionaryValueProvider

NameValueCollectionValueProvider采用一個NameValueCollection作為數據源，DictionnaryValueProvider的數據源類型自然就是一個Dictionnary。NameValueCollection和Dictionnary都是一個鍵值對的集合，它們之間的不同之處在NameValueCollection運行元素具有相同的Key，Dictionnary卻要求元素的Key具有唯一性。

一、DictionaryValueProvider<TValue>

DictionnaryValueProvider的類型全名為System.Web.Mvc.DictionaryValueProvider<TValue>，如下面的代碼片斷所示，DictionaryValueProvider<TValue>實現了IEnumerableValueProvider和IValueProvider接口，構造函數接受一個IDictionary<string, TValue>對象，該對象表示作為數據源的字典。定義在DictionaryValueProvider<TValue>中所有方法的邏輯與定義在NameValueCollectionValueProvider中的同名方法並沒有本質區別。

   1: public class DictionaryValueProvider<TValue> : IEnumerableValueProvider, IValueProvider
   2: {
   3:     public DictionaryValueProvider(IDictionary<string, TValue> dictionary, CultureInfo culture);
   4:     public virtual bool ContainsPrefix(string prefix);
   5:     public virtual IDictionary<string, string> GetKeysFromPrefix(string prefix);
   6:     public virtual ValueProviderResult GetValue(string key);
   7: }

二、RouteDataValueProvider

將當前路由數據作為數據源的RouteDataValueProvider繼承自DictionaryValueProvider<TValue>。如下面的代碼片斷所示，基於當前Controller上下文構建的RouteDataValueProvider直接將表示當前路由數據的RouteData對象的Values屬性（這是一個RouteValueDictionary對象）作為數據來源。

   1: public sealed class RouteDataValueProvider : DictionaryValueProvider<object>
   2: {
   3:     public RouteDataValueProvider(ControllerContext controllerContext) :
   4:         base(controllerContext.RouteData.Values, CultureInfo.InvariantCulture)
   5:     {
   6:     }
   7: }

三、HttpFileCollectionValueProvider

我們可以通過類型為file的輸入元素進行文件的上傳，在表示HTTP請求的HttpRequestBase對象中，上傳文件通過只讀屬性Files表示。從下面的代碼片斷所示，該屬性類型為HttpFileCollectionBase，是一個元素類型為HttpPostedFileBase的集合。

   1: public abstract class HttpRequestBase
   2: {
   3:     public virtual HttpFileCollectionBase Files { get; }
   4: }
   5: public abstract class HttpFileCollectionBase : NameObjectCollectionBase, ICollection, IEnumerable
   6: {
   7:     public virtual string[] AllKeys { get; }
   8:     public override int Count { get; }
   9:     public virtual HttpPostedFileBase this[int index] { get; }
  10:     public virtual HttpPostedFileBase this[string name] { get; }
  11: }
  12: public abstract class HttpPostedFileBase
  13: {
  14:     public virtual void SaveAs(string filename);
  15:
  16:     public virtual int ContentLength { get; }
  17:     public virtual string ContentType { get; }
  18:     public virtual string FileName { get; }
  19:     public virtual Stream InputStream { get; }
  20: }

用於處理上傳文件的Action方法通常定義類型為HttpPostedFileBase及其列表的參數來表示上傳的文件，針對HttpPostedFileBase參數的Model綁定選用的數據就來源於表示當前請求的HttpRequestBase的Files屬性，而具體參數值的提供最終通過具有如下定義的HttpFileCollectionValueProvider來實現。

   1: public sealed class HttpFileCollectionValueProvider : DictionaryValueProvider<HttpPostedFileBase[]>
   2: {
   3:     public HttpFileCollectionValueProvider(ControllerContext controllerContext);
   4: }