DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> XML學習教程 >> XML詳解
XML + DataSet + DataGrid:廣告管理程式實作(二)
編輯:XML詳解     

這個範例把三個元件湊在一起: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 定義

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 又把分頁與編輯的樣板程式碼全包了。對設定類、項目不多的管理後台來說,這是非常划算的組合。

限制也該看清:

  • 整份 XML 讀進 DataSet 再整份寫回,沒有交易保護。寫檔中途失敗會留下半截檔案,原本完整的資料就此毀損。正式環境應先寫暫存檔再覆蓋,並保留備份。
  • 多個管理者同時編輯時,後寫的會蓋掉先寫的,因為每次都是「記憶體中的完整快照」覆寫檔案。
  • 索引換算依賴 PageSize,這是最容易出錯的一環。範例中寫死的 5 與實際設定的 10 不一致,就是個活生生的警訊——應改讀 dgXML.PageSize。
  • 資料量一大,效能會明顯下滑。DataSet 是整份載入的架構,超過某個規模就該換成真正的資料庫。

把這套組合用在對的位置——設定檔、選項清單、廣告輪播表這類資料量有限的管理介面——它依然是相當俐落的方案。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved