DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> XML學習教程 >> XML詳解
用 XML、DataSet 與 DataGrid 做一個廣告管理程式
編輯:XML詳解     

本文示範 ASP.NET 中 XML 的用法,重點放在 XML 與 DataSet 的結合。其實 ASP.NET 操作 XML 的物件相當多,例如 XmlDataDocument、XmlTextReader 等,功能都很完整實用。

範例以 AdRotator 控制項所用的 XML 為素材,做出一個廣告管理程式。用到的控制項主要是 DataGrid,幾乎把它的功能都用了一遍,因此在關注 XML 的同時,也能順便學到 DataGrid 的用法。

先說明幾個關鍵 API

DataSet 這裡主要用 ReadXml 與 WriteXml,看名字就知道用途:把 XML 讀進記憶體、把改動寫回檔案。

DataGrid 則用到大量方法與屬性:分頁靠 AllowPaging,排序靠 AllowSorting;事件方面幾乎全用上了,包含 OnItemCommand、OnEditCommand、OnCancelCommand、OnUpdateCommand 與 PageIndexChanged。建議逐一留意這些事件的處理時機。

順帶比較一下:同樣的功能若用傳統 ASP 來寫,大概得拆成好幾頁;用 ASP.NET 只需一頁,而且可以重複使用。

我們操作的 XML 檔

這裡刻意只列兩筆廣告,實際的 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 編輯、改完再寫回去。整個後端不需要一個資料表,卻擁有完整的增刪改查體驗。

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