本文示範 ASP.NET 中 XML 的用法,重點放在 XML 與 DataSet 的結合。其實 ASP.NET 操作 XML 的物件相當多,例如 XmlDataDocument、XmlTextReader 等,功能都很完整實用。
範例以 AdRotator 控制項所用的 XML 為素材,做出一個廣告管理程式。用到的控制項主要是 DataGrid,幾乎把它的功能都用了一遍,因此在關注 XML 的同時,也能順便學到 DataGrid 的用法。
DataSet 這裡主要用 ReadXml 與 WriteXml,看名字就知道用途:把 XML 讀進記憶體、把改動寫回檔案。
DataGrid 則用到大量方法與屬性:分頁靠 AllowPaging,排序靠 AllowSorting;事件方面幾乎全用上了,包含 OnItemCommand、OnEditCommand、OnCancelCommand、OnUpdateCommand 與 PageIndexChanged。建議逐一留意這些事件的處理時機。
順帶比較一下:同樣的功能若用傳統 ASP 來寫,大概得拆成好幾頁;用 ASP.NET 只需一頁,而且可以重複使用。
這裡刻意只列兩筆廣告,實際的 ad_gb.xml 會有多筆同結構的 Ad 節點:
<?XML version="1.0" standalone="yes"?> <Advertisements> <xsd:schema id="Advertisements" targetNamespace="" xmlns="" xmlns:xsd="https://www.w3.org/1999/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:XML-msdata"> <xsd:element name="Ad"> <xsd:complexType content="elementOnly"> <xsd:all> <xsd:element name="ImageUrl" minOccurs="0" type="xsd:string"/> <xsd:element name="NavigateUrl" minOccurs="0" type="xsd:string"/> <xsd:element name="AlternateText" minOccurs="0" type="xsd:string"/> <xsd:element name="Keyword" minOccurs="0" type="xsd:string"/> <xsd:element name="Impressions" minOccurs="0" type="xsd:string"/> </xsd:all> </xsd:complexType> </xsd:element> <xsd:element name="Advertisements" msdata:IsDataSet="True"> <xsd:complexType> <xsd:choice maxOccurs="unbounded"> <xsd:element ref="Ad"/> </xsd:choice> </xsd:complexType> </xsd:element> </xsd:schema> <Ad> <ImageUrl>ASPcn_bbs1.gif</ImageUrl> <NavigateUrl>https://www.ASPcn.com/bbs</NavigateUrl> <AlternateText>www.knowsky.com</AlternateText> <Keyword>bbs</KeyWord> <Impressions>50</Impressions> </Ad> <Ad> <ImageUrl>https://www.aspcn.com/ASPcn.gif</ImageUrl> <NavigateUrl>https://www.ASPcn.com</NavigateUrl> <AlternateText>www.knowsky.com</AlternateText> <Keyword>首頁連結</KeyWord> <Impressions>80</Impressions> </Ad> </Advertisements>
這正是 AdRotator 控制項引用的標準格式。XML 內嵌的那段 xsd:schema 是平時用 DataSet 寫入時自動產生的結構描述,留著不影響使用。
<%@ Page Language="C#" ResponseEncoding="gb2312" %>
<%@ Import Namespace="System.Data" %>
<%@ Import Namespace="System.XML" %>
<%@ Import Namespace="System.IO" %>
<script language="C#" runat="server">
DataSet ds; // 公用 DataSet
DataView dv; // 公用 DataView
string sPath;
public void Page_Load(Object src, EventArgs e) {
if (State["adXML"] == null) {
sPath = Server.MapPath(".") + "\AdBanners\ad_gb.xml";
ds = new DataSet();
ds.ReadXml(sPath);
State["adXML"] = ds;
} else {
ds = (DataSet)State["adXML"];
}
dv = ds.Tables[0].DefaultView;
dv.Sort = "ImageUrl";
if (!Page.IsPostBack) {
CreateTable();
}
}
// 資料綁定
public void CreateTable() {
dgXML.DataSource = dv;
dgXML.DataBind();
}
// 換頁
public void dgXML_Changed(Object sender, DataGridPageChangedEventArgs e) {
dgXML.CurrentPageIndex = e.NewPageIndex;
CreateTable();
}
// 刪除
public void DelItem(Object sender, DataGridCommandEventArgs e) {
if (((LinkButton)e.CommandSource).CommandName == "del") {
int CPI = dgXML.CurrentPageIndex;
int EII = e.Item.ItemIndex;
int row = CPI * dgXML.PageSize + EII;
dv.Delete(row);
dgXML.EditItemIndex = -1;
ds.WriteXml(sPath);
CreateTable();
}
}
// 取消編輯
public void dgXML_Cancel(Object sender, DataGridCommandEventArgs e) {
dgXML.EditItemIndex = -1;
CreateTable();
}
// 進入編輯
public void dgXML_Edit(Object sender, DataGridCommandEventArgs e) {
dgXML.EditItemIndex = e.Item.ItemIndex;
CreateTable();
}
// 更新
public void dgXML_Update(Object sender, DataGridCommandEventArgs e) {
try {
int CPI = dgXML.CurrentPageIndex;
int EII = e.Item.ItemIndex;
int row = CPI * dgXML.PageSize + EII;
string ImageUrl = ((TextBox)e.Item.Cells[2].Controls[0]).Text;
string NavigateUrl = ((TextBox)e.Item.Cells[3].Controls[0]).Text;
string AlternateText = ((TextBox)e.Item.Cells[4].Controls[0]).Text;
string KeyWord = ((TextBox)e.Item.Cells[5].Controls[0]).Text;
string Impressions = ((TextBox)e.Item.Cells[6].Controls[0]).Text;
dv.Delete(row);
DataRow dr = ds.Tables[0].NewRow();
dr[0] = ImageUrl;
dr[1] = NavigateUrl;
dr[2] = AlternateText;
dr[3] = KeyWord;
dr[4] = Impressions;
ds.Tables[0].Rows.Add(dr);
ds.WriteXml(sPath);
} catch (Exception ee) {
lb.Text = ee.ToString();
}
dgXML.EditItemIndex = -1;
CreateTable();
}
public void PanelShow(Object sender, EventArgs e) {
AddItem.Visible = true;
}
public void AddItem_Click(Object sender, EventArgs e) {
DataRow dr = ds.Tables[0].NewRow();
dr[0] = mUrl.Text;
dr[1] = aUrl.Text;
dr[2] = mText.Text;
dr[3] = aKey.Text;
dr[4] = aTime.Text;
ds.Tables[0].Rows.Add(dr);
ds.WriteXml(sPath);
CreateTable();
AddItem.Visible = false;
}
</script>
頁面宣告部分:
<form id="form1" runat="server"> <ASP:DataGrid id="dgXML" runat="server" AllowPaging="True" PageSize="10" AutoGenerateColumns="false" OnPageIndexChanged="dgXML_Changed" OnEditCommand="dgXML_Edit" OnCancelCommand="dgXML_Cancel" OnUpdateCommand="dgXML_Update" OnItemCommand="DelItem"> <Columns> <ASP:ButtonColumn HeaderText="刪除" Text="刪除" CommandName="del" /> <ASP:EditCommandColumn EditText="修改" CancelText="取消" UpdateText="更新" HeaderText="操作區" /> <ASP:BoundColumn HeaderText="圖片位址" SortExpression="ImageUrl" DataField="ImageUrl" /> <ASP:BoundColumn HeaderText="連結網址" SortExpression="NavigateUrl" DataField="NavigateUrl" /> <ASP:BoundColumn HeaderText="圖片說明" SortExpression="AlternateText" DataField="AlternateText" /> <ASP:BoundColumn HeaderText="類別" SortExpression="Keyword" DataField="Keyword" /> <ASP:BoundColumn HeaderText="顯示次數" SortExpression="Impressions" DataField="Impressions" /> </Columns> </ASP:DataGrid>> <ASP:Button id="vi" Text="添加新項" OnClick="PanelShow" runat="server" /> <ASP:Panel id="AddItem" runat="server" Visible="false"> <table> <tr><td>廣告圖片:</td> <td><ASP:TextBox id="mUrl" runat="server" /></td></tr> <tr><td>廣告連結位址:</td> <td><ASP:TextBox id="aUrl" runat="server" /></td></tr> <tr><td>圖片說明:</td> <td><ASP:TextBox id="mText" runat="server" /></td></tr> <tr><td>廣告類別:</td> <td><ASP:TextBox id="aKey" runat="server" /></td></tr> <tr><td>顯示次數:</td> <td><ASP:TextBox id="aTime" runat="server" /></td></tr> <tr><td colspan="2"> <ASP:Button id="submit" Text="提交" OnClick="AddItem_Click" runat="server" /> </td></tr> </table> </ASP:Panel> <ASP:Label id="lb" runat="server" /> </form>
用 State 保存 DataSet。Page_Load 一開始就檢查 State["adXML"],第一次載入時讀檔並存入狀態,後續回傳直接取用。這樣就不必每次 PostBack 都重讀檔案。
分頁索引換算成資料列索引。刪除與更新時,真正要操作的是 dv 中的第幾列,而 DataGrid 給的是「目前頁內第幾列」。兩者換算方式是:row = CurrentPageIndex * PageSize + e.Item.ItemIndex。範例中原本硬寫 5,這裡改用 PageSize 讓它跟著設定走,比較保險。
更新為什麼要先刪再新增。呼叫 dv.Delete(row) 之後,直接改寫該列並不容易,因此這裡採「刪掉舊列、用新值建一筆 DataRow 加進去」的做法。代價是該筆資料會被移到資料表尾端——若在意排序,記得重新設定 dv.Sort。
每次改動都要 WriteXml。新增、刪除、更新三條路徑的最後一步都是 ds.WriteXml(sPath),把記憶體中的變更落地成檔案,這樣廣告設定才會真正保存。
中文顯示問題。原始 XML 檔案中的中文可能出現亂碼,但程式執行時能正常顯示,這是因為輸出了 ResponseEncoding="gb2312" 並在全球化設定中對齊了編碼。
整體而言,這個範例最值得帶走的是那個模式:把 XML 當成輕量級資料庫,用 DataSet 讀進來、用 DataGrid 編輯、改完再寫回去。整個後端不需要一個資料表,卻擁有完整的增刪改查體驗。