jQuery 自帶的 Ajax 函式很好用,可以從遠端服務抓網頁回來。但多數範例都以 GET 為主,一旦你想用 POST 把資料送進 ASP.NET MVC 的控制器,就會發現事情沒那麼順利。
$.ajax() 確實有 data 參數可以帶資料,但預設是 GET 方式,也就是把內容附加在網址查詢字串後面。這麼一來,你會直接撞上 URL 長度上限(實務上約 4KB 以內才算安全)。更麻煩的是,就算你把 type 改成 POST,控制器端往往還是收不到任何值。

以下這段程式碼看起來完全正常,點下提交按鈕後,控制器卻連一次都沒被觸發:
<script type="text/javascript" src="Scripts/jquery-1.4.2.min.js"></script>
<script type="text/javascript">
var annotation_catalog_url = '/Comment/Save';
function save_handler() {
var html = tinyMCE.get('note_editor').getContent();
var comment = {
Id: -1,
User: '',
PageUrl: '' + window.location.href,
Content: html
};
$.ajax({
url: annotation_catalog_url,
type: 'POST',
dataType: 'json',
data: comment,
contentType: 'application/json; charset=utf-8',
success: function (data) {
if (data != null) {
$('#result').html(data.Message);
}
}
});
}
$(document).ready(function () {
$('#submit').click(save_handler);
});
</script>
你在 dataType 裡宣告了 json,但 data 傳進去的還只是一個普通的 JavaScript 物件,並沒有被序列化成 JSON 字串。伺服器端收到的是一團它讀不懂的內容。
解法是把物件序列化。引入 json2.js(可自 json.org 取得)之後,改寫那一行即可:

<script type="text/javascript" src="Scripts/json2.js"></script> // ……其餘程式碼不變,只改這一行 data: JSON.stringify(comment),
順帶一提,dataType 描述的是「預期收到的回應格式」,contentType 描述的才是「送出的內容格式」。兩者搞混是常見的誤解來源。
如果客戶端已經正確送出了 JSON,控制器端卻還是拿到 null(使用 ASP.NET MVC 3 RC 之前版本時特別容易遇到),那是因為 MVC 的模型繫結器不知道該怎麼解讀這個物件。要補上支援,請在 Global.asax.cs 的 Application_Start() 裡加一行:
ValueProviderFactories.Factories.Add(new JsonValueProviderFactory());
這行註冊之後,MVC 才知道要怎麼把 JSON 還原成模型物件。若你使用的是 ASP.NET MVC 3 RC 以後的版本,這個 factory 已經內建註冊,不需要再自己加。
POST JSON 到 MVC 控制器,三件事缺一不可:contentType 標明 application/json、資料以 JSON.stringify() 序列化、伺服器端具備 JSON 值提供者。三者齊備,控制器就能正常收到資料了。