Bootstrap檔案上傳外掛File Input是一個不錯的檔案上傳控制元件，但是搜尋使用到的案例不多，使用的時候，也是一步一個腳印一樣摸著石頭過河，這個控制元件在介面呈現上，叫我之前使用過的Uploadify 好看一些，功能也強大些，本文主要基於我自己的框架程式碼案例，介紹其中檔案上傳外掛File Input的使用。關於Uploadify的控制元件介紹，可以參考我之前的隨筆介紹《基於MVC4+EasyUI的Web開發框架形成之旅--附件上傳元件uploadify的使用》。

1、檔案上傳外掛File Input介紹

這是一個增強的 HTML5 檔案輸入控制元件，是一個 Bootstrap 3.x 的擴充套件，實現檔案上傳預覽，多檔案上傳等功能。

一般情況下，我們需要引入下面兩個檔案，外掛才能正常使用：

bootstrap-fileinput/css/fileinput.min.css

bootstrap-fileinput/js/fileinput.min.js

簡單的介面效果如下所示，和眾多上傳檔案控制元件一樣，可以接受各種型別的檔案。當然，我們也可以指定具體接受的檔案型別等功能。

如果需要考慮中文化，那麼還需要引入檔案：

bootstrap-fileinput/js/fileinput_locale_zh.js

這樣基於MVC的Bundles集合，我們把它們所需要的檔案加入到集合裡面即可。

            //新增對bootstrap-fileinput控制元件的支援
 

            css_metronic.Include("~/Content/MyPlugins/bootstrap-fileinput/css/fileinput.min.css");
            js_metronic.Include("~/Content/MyPlugins/bootstrap-fileinput/js/fileinput.min.js");
            js_metronic.Include("~/Content/MyPlugins/bootstrap-fileinput/js/fileinput_locale_zh.js");

這樣我們在頁面裡面，就可以呈現出中文的介面說明和提示了，如下介面所示。

2、檔案上傳外掛File Input的使用

一般情況下，我們可以定義一個JS的通用函式，用來初始化這個外掛控制元件的，如下JS的函式程式碼所示。

//初始化fileinput控制元件（第一次初始化）
function initFileInput(ctrlName, uploadUrl) {    
    var control = $('#' + ctrlName); 

    control.fileinput({
        language: 'zh', //設定語言
        uploadUrl: uploadUrl, //上傳的地址
        allowedFileExtensions : ['jpg', 'png','gif'],//接收的檔案字尾
        showUpload: false, //是否顯示上傳按鈕
        showCaption: false,//是否顯示標題
        browseClass: "btn btn-primary", //按鈕樣式             
        previewFileIcon: "<i class='glyphicon glyphicon-king'></i>", 
    });
}

頁面程式碼裡面，我們放置一個檔案上傳控制元件，如下程式碼所示。

  <div class="row" style="height: 500px">
           <input id="file-Portrait1" type="file">
    </div>

這樣我們指令碼程式碼的初始化程式碼如下：

            //初始化fileinput控制元件（第一次初始化）
            initFileInput("file-Portrait", "/User/EditPortrait");

這樣就完成了控制元件的初始化了，如果我們需要上傳檔案，那麼還需要JS的程式碼處理客戶端上傳的事件，同時也需要MVC後臺控制器處理檔案的儲存操作。

例如我對窗體資料的儲存處理程式碼如下所示。

            //新增記錄的窗體處理
            formValidate("ffAdd", function (form) {
                $("#add").modal("hide");
                //構造引數傳送給後臺
                var postData = $("#ffAdd").serializeArray();
                $.post(url, postData, function (json) {
                    var data = $.parseJSON(json);
                    if (data.Success) {
                        //增加肖像的上傳處理
                        initPortrait(data.Data1);//使用寫入的ID進行更新
                        $('#file-Portrait').fileinput('upload');

                        //儲存成功  1.關閉彈出層，2.重新整理表格資料
                        showTips("儲存成功");
                        Refresh();
                    }
                    else {
                        showError("儲存失敗:" + data.ErrorMessage, 3000);
                    }
                }).error(function () {
                    showTips("您未被授權使用該功能，請聯絡管理員進行處理。");
                });
            });

其中我們注意到檔案儲存的處理邏輯程式碼部分：

   //增加肖像的上傳處理
   initPortrait(data.Data1);//使用寫入的ID進行更新
   $('#file-Portrait').fileinput('upload');

第一行程式碼就是重新構建上傳的附加內容，如使用者的ID資訊等，這樣我們就可以根據這些ID來構建一些額外的資料給後臺上傳處理了。

這個函式主要就是重新給ID賦值，方便上傳的時候，獲取最新的附加引數，這個和Uploadify的處理模式一樣的。

        //初始化影象資訊
        function initPortrait(ctrlName, id) {
            var control = $('#' + ctrlName);
            var imageurl = '/PictureAlbum/GetPortrait?id=' + id + '&r=' + Math.random();

            //重要，需要更新控制元件的附加引數內容，以及圖片初始化顯示
            control.fileinput('refresh', {
                uploadExtraData: { id: id },
                initialPreview: [ //預覽圖片的設定
                    "<img src='" + imageurl + "' class='file-preview-image' alt='肖像圖片' title='肖像圖片'>",
                ],
            });
        }

前面我們看到，我上傳的地址為："/User/EditPortrait"，這個後臺的函式我也公佈一下，希望給大家一個完整的案例程式碼學習。

        /// <summary>
        /// 上傳使用者頭像圖片
        /// </summary>
        /// <param name="id">使用者的ID</param>
        /// <returns></returns>
        public ActionResult EditPortrait(int id)
        {
            CommonResult result = new CommonResult();

            try
            {
                var files = Request.Files;
                if (files != null && files.Count > 0)
                {
                    UserInfo info = BLLFactory<User>.Instance.FindByID(id);
                    if (info != null)
                    {
                        var fileData = ReadFileBytes(files[0]);
                        result.Success = BLLFactory<User>.Instance.UpdatePersonImageBytes(UserImageType.個人肖像, id, fileData);
                    }
                }
            }
            catch (Exception ex)
            {
                result.ErrorMessage = ex.Message;
            }

            return ToJsonContent(result);
        }

這樣我們就構建了上面的使用者肖像的儲存處理邏輯了，檔案可以正常的儲存到後臺的檔案系統裡面，同時資料庫裡面記錄一些必備的資訊。

當然，除了用來處理使用者的肖像圖片，我們也可以用來構建圖片相簿的處理操作的，具體介面如下所示。

這部分的初始化程式碼如下所示：

            //初始化fileinput控制元件（第一次初始化）
            $('#file-Portrait').fileinput({
                language: 'zh', //設定語言
                uploadUrl: "/FileUpload/Upload", //上傳的地址
                allowedFileExtensions : ['jpg', 'png','gif'],//接收的檔案字尾,
                maxFileCount: 100,
                enctype: 'multipart/form-data',
                showUpload: true, //是否顯示上傳按鈕
                showCaption: false,//是否顯示標題
                browseClass: "btn btn-primary", //按鈕樣式             
                previewFileIcon: "<i class='glyphicon glyphicon-king'></i>", 
                msgFilesTooMany: "選擇上傳的檔案數量({n}) 超過允許的最大數值{m}！",
            });

如果有興趣，可以繼續參考系列文章：