對於 ASP.Net 開發者來說,User Control(.ascx)想必並不陌生。它是一個具備獨立邏輯的可複用組件,合理使用能大幅提升開發效率。事實上,借助 User Control 直接生成 HTML 內容,早已是一個頗為實用的技巧——尤其在 Ajax 盛行的年代更是如此。然而網上相關的系統講解並不多,不少朋友仍在辛苦地手動拼接字符串。本文就通過一個「評論列表」的實例,帶大家領略這一技巧的妙處。
對文章、圖片、音樂等對象進行評論,是最常見的功能之一。我們先定義一個 Comment 類,並為它準備一些示例數據與分頁獲取方法:
public partial class Comment
{
public DateTime CreateTime { get; set; }
public string Content { get; set; }
}
public partial class Comment
{
private static List<Comment> s_comments = new List<Comment>
{
new Comment { CreateTime = DateTime.Parse("2007-1-1"), Content = "今天天氣不錯" },
new Comment { CreateTime = DateTime.Parse("2007-1-2"), Content = "挺風和日麗的" },
new Comment { CreateTime = DateTime.Parse("2007-1-3"), Content = "我們下午沒有課" }
};
public static List<Comment> GetComments(int pageSize, int pageIndex, out int totalCount)
{
totalCount = s_comments.Count;
List<Comment> comments = new List<Comment>(pageSize);
for (int i = pageSize * (pageIndex - 1);
i < pageSize * pageIndex && i < s_comments.Count; i++)
{
comments.Add(s_comments[i]);
}
return comments;
}
}
為了展示評論列表,我們創建一個用戶控件 ItemComments.Ascx 來封裝界面與分頁。借助 Repeater 綁定數據,再配合簡單的上一頁、下一頁鏈接:
<asp:Repeater runat="server" ID="rptComments">
<ItemTemplate>
時間:<%# (Container.DataItem as Comment).CreateTime.ToString() %><br />
內容:<%# (Container.DataItem as Comment).Content %>
</ItemTemplate>
<SeparatorTemplate><hr /></SeparatorTemplate>
</asp:Repeater>
在後台代碼中,我們重寫 OnPreRender,把分頁數據綁定到 Repeater 上,並通過 PageIndex、PageSize 等屬性對外暴露配置:
public partial class ItemComments : System.Web.UI.UserControl
{
protected override void OnPreRender(EventArgs e)
{
base.OnPreRender(e);
this.rptComments.DataSource = Comment.GetComments(
this.PageSize, this.PageIndex, out this.m_totalCount);
this.DataBind();
}
public int PageIndex { get; set; }
public int PageSize { get; set; }
private int m_totalCount;
public int TotalCount { get { return this.m_totalCount; } }
}
封裝完成後,即可像使用普通控件一樣,在頁面 ViewItem.Aspx 中直接引用它,並在 Page_Load 中傳入當前的頁碼:
<div id="comments"> <demo:ItemComments ID="itemComments" runat="server" /> </div>
最終渲染出的效果,便是一份帶有時間、內容與分頁鏈接的整潔評論列表。
相比手動拼接字符串,使用 User Control 生成 HTML 的優勢顯而易見:界面與邏輯高度封裝、可複用性極強、利於維護。在 Ajax 場景下,服務端只需返回這段經過封裝的 HTML 片段,前端即可無刷新地更新局部內容,既減少了客戶端拼裝的負擔,也讓代碼結構更加清晰。這正是「一次封裝,多處受益」的編程智慧。