這個範例把三個元件湊在一起:XML 當資料存放格式、DataSet 當記憶體中的資料容器、DataGrid 當畫面上的編輯介面。三者搭配之後,一個具備分頁、編輯、刪除、新增功能的廣告輪播管理程式,幾乎不必寫資料庫相關的程式碼。
頁面宣告了必要的命名空間,並定義兩個全域變數——DataSet 存資料、DataView 提供排序與篩選後的檢視:
<%@ 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; // 存入 Page State,避免每次回發都重讀檔案
}
else
{
ds = (DataSet)State["adXML"];
}
dv = ds.Tables[0].DefaultView;
dv.Sort = "ImageUrl";
if (!Page.IsPostBack)
{
CreateTable();
}
}
這裡有個關鍵設計:把 DataSet 放進 State 集合,讓後續的編輯、刪除、分頁等回發動作不必重新讀檔,直接在記憶體中操作,最後一次寫回 XML。這比每個動作都重讀重寫檔案有效率得多。
綁定只是兩行,翻頁時重複呼叫同一個方法即可:
public void CreateTable()
{
dgXML.DataSource = dv;
dgXML.DataBind();
}
public void dgXML_Changed(Object sender, DataGridPageChangedEventArgs e)
{
CreateTable();
}
這是整個範例最需要留意的地方。DataGrid 的 ItemIndex 是當前頁內的索引,而 DataView 的 Delete 需要整份資料集的絕對索引,兩者必須換算:
public void DelItem(Object sender, DataGridCommandEventArgs e)
{
if (((LinkButton)e.CommandSource).CommandName == "del")
{
int CPI = (int)dgXML.CurrentPageIndex; // 目前頁碼
int EII = (int)e.Item.ItemIndex; // 頁內索引
int row = CPI * 5 + EII; // 換算成絕對索引
dv.Delete(row);
dgXML.EditItemIndex = -1;
ds.WriteXML(sPath); // 寫回 XML
CreateTable();
}
}
注意那個 5。範例中寫死了每頁列數,但 DataGrid 實際設定的 PageSize 是 10,兩者不一致會導致刪錯列。正確做法應該是讀取 dgXML.PageSize 而非硬編數字——這類「設定改了、換算公式沒跟著改」的問題,是 this 種索引換算程式最典型的錯誤來源。
進入編輯模式只需指定列索引:
public void dgXML_Edit(Object sender, DataGridCommandEventArgs e)
{
dgXML.EditItemIndex = (int)e.Item.ItemIndex;
CreateTable();
}
public void dgXML_Cancel(Object sender, DataGridCommandEventArgs e)
{
dgXML.EditItemIndex = -1;
CreateTable();
}
更新時,先換算索引,再從各儲存格的 TextBox 取出使用者輸入的值:
public void dgXML_Update(Object sender, DataGridCommandEventArgs e)
{
try
{
int CPI = (int)dgXML.CurrentPageIndex;
int EII = (int)e.Item.ItemIndex;
int row = CPI * 5 + 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;
// 由於 DataView 不支援就地修改,採「刪舊加新」的方式更新
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();
}
「刪舊加新」是為了繞過一個限制:DataView 本身不提供修改列的介面,而直接改 DataRow 的值又不一定會反映到已排序的檢視上。先刪再插雖然樸素,卻能確保資料與排序狀態一致。代價是原本的位置會改變,若排序欄位是 ImageUrl,更新後該列會跳到新的排序位置——這個副作用在實務上要能被接受,或者改用 DataTable 的 Rows.Find 定位後直接改值。
新增用一個隱藏的 Panel 承載輸入欄位,按下按鈕時顯示,提交後隱藏:
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>
DataGrid 的欄位以 property 區塊明確定義,關閉 AutoGenerateColumns 才能完全掌控欄位順序與表頭文字:
<ASP:DataGrid id="dgXML" runat="server"
AllowPaging="True"
PageSize="10"
CellPadding="3"
Font-Name="Verdana" Font-Size="8pt"
HeaderStyle-BackColor="#aaaadd"
PagerStyle-Mode="NumericPages"
PagerStyle-HorizontalAlign="Right"
PagerStyle-PrevPageText="前頁"
PagerStyle-NextPageText="後頁"
OnPageIndexChanged="dgXML_Changed"
OnEditCommand="dgXML_Edit"
OnCancelCommand="dgXML_Cancel"
OnUpdateCommand="dgXML_Update"
OnItemCommand="DelItem"
AutoGenerateColumns="false">
<Columns>
<ASP:ButtonColumn HeaderText="刪除" Text="刪除" CommandName="del" />
<ASP:EditCommandColumn EditText="修改" CancelText="取消" UpdateText="更新"
HeaderText="操作區" />
<ASP:BoundColumn HeaderText="圖片位址(相對)" SortExpression="ImageUrl"
DataField="ImageUrl" />
<ASP:BoundColumn HeaderText="連結 URL" 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>
新增用的 Panel 則是普通的表單欄位:
<ASP:Button id="vi" Text="新增項目" OnClick="PanelShow" runat="server" />
<ASP:Panel id="AddItem" runat="server" Visible="false">
<table>
<tr><td>廣告圖片 URL:</td>
<td><ASP:TextBox id="mUrl" runat="server" Text="https://" /></td></tr>
<tr><td>廣告連結位址:</td>
<td><ASP:TextBox id="aUrl" runat="server" Text="https://" /></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><ASP:Button id="submit" Text="提交"
OnClick="AddItem_Click" runat="server" /></td></tr>
</table>
</ASP:Panel>
長處是開發速度。XML 檔案可以人工編輯、可以版本控制、部署時不必準備資料庫,而 DataSet 把「讀檔 → 表格 → 畫面」這條路鋪得極順,DataGrid 又把分頁與編輯的樣板程式碼全包了。對設定類、項目不多的管理後台來說,這是非常划算的組合。
限制也該看清:
dgXML.PageSize。把這套組合用在對的位置——設定檔、選項清單、廣告輪播表這類資料量有限的管理介面——它依然是相當俐落的方案。