DataSet 是 .NET 中很典型的資料容器。這個實例示範如何在 WebService 中組出 DataSet,並用 jQuery 在前端把它解析成畫面上的內容。
[WebMethod]
public DataSet GetDataSet()
{
DataSet ds = new DataSet();
DataTable dt = new DataTable();
dt.Columns.Add("Name", Type.GetType("System.String"));
dt.Columns.Add("Password", Type.GetType("System.String"));
DataRow dr = dt.NewRow();
dr["Name"] = "小花";
dr["Password"] = "aaaaaaaaa";
dt.Rows.Add(dr);
dr = dt.NewRow();
dr["Name"] = "小兵";
dr["Password"] = "bbbbbbbbb";
dt.Rows.Add(dr);
ds.Tables.Add(dt);
return ds;
}
DataSet 序列化後就是標準 XML,因此前端可以用一般 XML 解析的方式處理。
$(document).ready(function() {
$('#btnDataset').click(function() {
$.ajax({
type: "POST",
url: "WebService.asmx/GetDataSet",
data: "{}",
dataType: 'xml',
success: function(result) {
try {
$(result).find("Table1").each(function() {
$('#dd').append(
$(this).find("Name").text() + " "
+ $(this).find("Password").text()
);
});
} catch (e) {
alert(e);
return;
}
},
error: function(result, status) {
if (status == 'error') {
alert(status);
}
}
});
});
});
因為宣告了 dataType: 'xml',jQuery 會把回應解析成 XML 文件物件,接著就能用 find 定位到每一筆資料列,再用 each 逐一取出欄位。這裡的 Table1 是 DataSet 序列化時自動產生的節點名稱,依 Table 的命名而定,實作時要對照實際回應確認。
成功與失敗要分開處理。範例同時設了 success 與 error,這是正確做法。只寫 success 的話,一旦伺服器出錯或回傳格式不符,畫面會靜默地什麼都不顯示,很難排查。
用 append 而非 html。在迴圈中 append 是對的,因為 html 會把先前的內容整個蓋掉。不過更有效率的做法是在迴圈外先收集到陣列,最後一次寫入,避免反覆觸發 DOM 更新。
用 DataSet 傳輸資料是早期 .NET 的習慣做法,但它的 XML 結構相當冗長——每個欄位、每個型別都會產生額外節點,前端解析時也得一層層 find,資料量大時頻寬與效能都不划算。
現代的作法是在 WebService 或 API 中回傳自訂的 DTO 類別,並以 JSON 序列化。前端只需 data.Name 就能取值,不必關心 XML 節點結構,整體程式碼會短上好幾倍。這個系列的後續實例若能搭配 JSON,會是更值得推薦的方向。