這次示範用 ASP.NET AJAX 1.0 做一個可重複使用的小型留言板控制項。資料庫選用 Access,主要是為了方便攜帶與部署——整個留言板就是一個 .mdb 檔加一支控制項。
資料表很簡單,表名 Guest,欄位為 ID、Name、Content。
AJAX 1.0 可從官方網站下載(此為當年之版本,今日請改用 Microsoft AJAX Library 或直接在 ASP.NET 4.0 以上使用內建的 UpdatePanel)。安裝完成後開啟 VS2005,新增一個「ASP.NET AJAX Enabled Web Site」專案,再加入一個 Web 使用者控制項 MiniGB.ascx。
<%@ Control Language="C#" ClassName="MiniGB" %>
<%@ Import Namespace="System.Data.OleDb" %>
<%@ Import Namespace="System.Data" %>
<script runat="server">
private OleDbConnection conn = new OleDbConnection(
"provider=microsoft.jet.oledb.4.0;data source="
+ System.Web.HttpContext.Current.Server.MapPath("guest.mdb"));
private string dname = "游客";
public string Dname {
get { return dname; }
set { dname = value; }
}
protected void Button1_Click(object sender, EventArgs e) {
if (TextBox1.Text.Trim() != "") {
OleDbCommand comm = new OleDbCommand(
"insert into guest(name,content) values('" + dname + "','"
+ TextBox1.Text.Trim() + "')", conn);
comm.ExecuteNonQuery();
listupdate();
TextBox1.Text = "";
}
}
private void listupdate() {
OleDbDataAdapter da = new OleDbDataAdapter(
"select top 5 * from guest order by id desc", conn);
DataSet ds = new DataSet();
da.Fill(ds);
DataList1.DataSource = ds;
DataList1.DataBind();
}
protected void Page_Load(object sender, EventArgs e) {
conn.Open();
listupdate();
}
</script>
邏輯分成三塊:Page_Load 開連線並載入最新五筆留言、Button1_Click 寫入新留言後重載、listupdate 負責查詢與繫結。留言人名稱由公開屬性 Dname 提供,預設是「游客」,宿主頁面可以覆寫它,例如填入目前登入者的帳號。
<style>
.Gtitle { width:200px; background-color:#464646; color:#FFFFFF; font-size:14px;
height:20px; padding:3px 0 0 10px; font-weight:bold;
border-style:solid; border-top-width:1px; border-left-width:1px;
border-right-width:1px; border-color:#BBBBBB; }
.Gbody { width:200px; border-left:1px solid #BBBBBB;
border-right:1px solid #BBBBBB; padding:3px 5px; }
.Gend { width:200px; border-left:1px solid #BBBBBB;
border-right:1px solid #BBBBBB; border-bottom:1px solid #BBBBBB;
padding:3px 5px; }
.Gname { width:190px; font-size:12px; color:blue; }
.Gcontent { width:190px; word-break:break-all; color:#444444; font-size:12px;
padding:3px 0; border-bottom:1px dotted #BBBBBB; }
</style>
<asp:ScriptManagerProxy ID="ScriptManagerProxy1" runat="server" />
<asp:UpdatePanel ID="UpdatePanel1" runat="server">
<ContentTemplate>
<div class="Gtitle"><asp:Label ID="Label1" runat="server" Text="留言板" /></div>
<div class="Gbody">
<asp:DataList ID="DataList1" runat="server">
<ItemTemplate>
<div class="Gname"><%# DataBinder.Eval(Container.DataItem, "name") %> 說:</div>
<div class="Gcontent"><%# DataBinder.Eval(Container.DataItem, "content") %></div>
</ItemTemplate>
</asp:DataList>
</div>
<div class="Gend">
<asp:TextBox ID="TextBox1" runat="server" Width="150px" />
<asp:Button ID="Button1" runat="server" Text="留言" OnClick="Button1_Click" />
</div>
</ContentTemplate>
</asp:UpdatePanel>
關鍵就是把留言列表與輸入區一起放進 ContentTemplate,按鈕於是觸發非同步回傳,送出留言後畫面不刷新、不跳動,只更新這一小塊。
完成控制項後,在任何頁面註冊即可使用:
<%@ Register Src="MiniGB.ascx" TagName="MiniGB" TagPrefix="uc1" %> ... <asp:ScriptManager ID="ScriptManager1" runat="server" /> <uc1:MiniGB ID="MiniGB1" runat="server" Dname="小明" />
注意:使用控制項的頁面必須有一個 ScriptManager(若控制項置於 Master Page 內,則用 ScriptManagerProxy),否則 UpdatePanel 不會生效。
範例為了精簡而省略了幾個必要環節,直接拿去用會有問題:
OleDbParameter 參數化查詢。Server.HtmlEncode。using 區塊中,用後即關,不要長期持有。MaxLength 並在伺服器端再驗證一次。把這四點補上,這就是一個可以安心放進任何頁面的迷你留言板了。