详解ASP.NET数据绑定操作中Repeater控件的用法
作者：zhang_xinxiu
.NET中的Repeater控件支持数据模板,而且可以自由地定义样式,这里我们就来详解ASP.NET数据绑定操作中Repeater控件的用法,需要的朋友可以参考下
一、绑定控件之Repeater
.NET封装了多种数据绑定控件，诸如GridView、DataList等但该篇文章将会从Repeater入手，因为Repeater只提供了基本的数据绑定模板，没有内置其它分页等功能，所以它是最原始的数据绑定控件，只要能够熟练运用Repeater控件其它的绑定控件也就很简单了。
1、Repeater简介
Repeater 控件是基本模板化数据列表。 它不像GridView控件一样能够可视化的设计格式或样式，因此开发时在控件模板中必须显式声明所有格式、格式和样式标记。另外Repeater控件没有内置选择、排序、编辑、分页等功能，它只提供了基本的数据绑定，但是它为开发人员提供了ItemCommand 事件，该事件支持在控件中收发命令。
想要绑定数据，模板是必不可少的，Repeater控件同样支持数据模板，而且还可以在模板中添加想要的标签，它主要用法如下图：
Note：每个 Repeater 控件必须定义 ItemTemplate。
二、控件使用技巧
上文讲解了Repeater基本的使用方法及它的一些基本特性，接下来做几个经典的示例来运用Repeater控件。
1、数据绑定之删除、编辑
该示例将会使用Asp.net的前台和后台结合来实现显示数据，并能够编辑和删除数据。
删除页面：
编辑页面：
前台代码：在单击编辑按钮后将会进入编辑页面，页面是由两个Panel控件来控制，通过传递ID号的方式判断显示的是编辑页面还是删除页面，另外前台代码通过设置控件的CommandArgument属性来传递后台所需要判断的id号。
<body>
<form id="form1" runat="server">
<div>
<asp:Repeater ID="userRepeat" runat="server" OnItemCommand="userRepeat_ItemCommand" OnItemDataBound="userRepeat_ItemDataBound">
<HeaderTemplate>
<table border="1" style="width:1000px;text-align:center;border-collapse:collapse;">
<thead style="background-color:red;">
<tr>
<th>ID</th>
<th>内容</th>
<th>操作</th>
</tr>
</thead>
</HeaderTemplate>
<ItemTemplate>
<asp:Panel ID="plItem" runat="server">
<tr>
<td><asp:Label runat="server" ID="lblID" Text='<%#Eval("id") %>'></asp:Label></td>
<td><%#Eval("name") %></td>
<td>
<asp:LinkButton ID="lbtEdit" CommandName="Edit" CommandArgument='<%#Eval("id") %>' runat="server">编辑</asp:LinkButton>
<asp:LinkButton ID="lbtDelete" CommandName="Delete" CommandArgument='<%#Eval("id") %>' runat="server">删除</asp:LinkButton>
</td>
</tr>
</asp:Panel>
<asp:Panel ID="plEdit" runat="server">
<tr>
<td><asp:Label runat="server" ID="Label1" Text='<%#Eval("id") %>'></asp:Label></td>
<td><asp:TextBox ID="txtName" runat="server" Text='<%#Eval("name") %>'></asp:TextBox></td>
<td>
<asp:LinkButton ID="lbtCancel" CommandName="Cancel" CommandArgument='<%#Eval("id") %>' runat="server">取消</asp:LinkButton>
<asp:LinkButton ID="lbtUpdate" CommandName="Update" CommandArgument='<%#Eval("id") %>' runat="server">更新</asp:LinkButton>
</td>
</tr>
</asp:Panel>
</ItemTemplate>
<FooterTemplate>
</table>
</FooterTemplate>
</asp:Repeater>
</div>
</form>
</body>
后台代码：在后台代码中很重要的两个事件是ItemCommand和ItemDataBound，其中ItemCommand负责接收前台传进来的按钮命令，根据命令的参数来设置后台传递的id，并在ItemDataBound中来验证id判断切换显示Panel。
using System;
using System.Collections.Generic;
using System.Data;
using System.Data.SqlClient;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
namespace WebApplication4
{
public partial class EditPage : System.Web.UI.Page
{
private int id = 0; //保存指定行操作所在的ID号
/// <summary>
/// 窗体加载时绑定数据
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
protected void Page_Load(object sender, EventArgs e)
{
if (!Page.IsPostBack)
{
this.DataBindToRepeater();//将数据绑定到Repeater控件上
}
}
/// <summary>
/// 将数据源绑定Repeater控件上
/// </summary>
private void DataBindToRepeater() {
//使用using语句进行数据库连接
using (SqlConnection sqlCon=new SqlConnection("server=.;database=MyBlog;uid=sa;pwd=1"))
{
sqlCon.Open(); //打开数据库连接
SqlCommand sqlcom = new SqlCommand(); //创建数据库命令对象
sqlcom.CommandText = "select * from match"; //为命令对象指定执行语句
sqlcom.Connection = sqlCon; //为命令对象指定连接对象
this.userRepeat.DataSource = sqlcom.ExecuteReader(); //为Repeater对象指定数据源
this.userRepeat.DataBind(); //绑定数据源
}
}
/// <summary>
/// Repeater控件命令事件
/// </summary>
/// <param name="source"></param>
/// <param name="e"></param>
protected void userRepeat_ItemCommand(object source, RepeaterCommandEventArgs e)
{
//获取命令文本，判断发出的命令为何种类型，根据命令类型调用事件
if (e.CommandName=="Edit") //编辑命令
{
id = int.Parse(e.CommandArgument.ToString()); //获取命令ID号
}
else if (e.CommandName=="Cancel") //取消更新命令
{
id = -1;
}
else if(e.CommandName=="Delete") //删除行内容命令
{
id = int.Parse(e.CommandArgument.ToString()); //获取删除行的ID号
//删除选定的行，并重新指定绑定操作
this.DeleteRepeater(id);
}
else if (e.CommandName == "Update") //更新行内容命令
{
//获取更新行的内容和ID号
string strText = ((TextBox)e.Item.FindControl("txtName")).Text.Trim();
int intId=int.Parse(((Label)e.Item.FindControl("lblID")).Text);
//更新Repeater控件的内容
this.UpdateRepeater(strText,intId);
}
//重新绑定控件上的内容
this.DataBindToRepeater();
}
/// <summary>
/// 删除行内容
/// </summary>
/// <param name="intId">删除行所在内容的ID</param>
private void DeleteRepeater(int intId) {
using (SqlConnection sqlCon = new SqlConnection("server=.;database=MyBlog;uid=sa;pwd=1"))
{
sqlCon.Open(); //打开数据库连接
SqlCommand sqlcom = new SqlCommand(); //创建数据库命令对象
sqlcom.CommandText = "delete from match where id=@id"; //为命令对象指定执行语句
sqlcom.Connection = sqlCon; //为命令对象指定连接对象
//创建参数集合,并向sqlcom中添加参数集合
SqlParameter sqlParam = new SqlParameter("@id", intId);
sqlcom.Parameters.Add(sqlParam);
sqlcom.ExecuteNonQuery(); //指定更新语句
}
}
/// <summary>
/// 更新Repeater控件中的内容
/// </summary>
/// <param name="strText">修改后的内容</param>
/// <param name="intId">内容所在行的ID号</param>
private void UpdateRepeater(string strText,int intId) {
using (SqlConnection sqlCon = new SqlConnection("server=.;database=MyBlog;uid=sa;pwd=1"))
{
sqlCon.Open(); //打开数据库连接
SqlCommand sqlcom = new SqlCommand(); //创建数据库命令对象
sqlcom.CommandText = "update match set name=@str where id=@id"; //为命令对象指定执行语句
sqlcom.Connection = sqlCon; //为命令对象指定连接对象
//创建参数集合,并向sqlcom中添加参数集合
SqlParameter[] sqlParam = { new SqlParameter("@str", strText), new SqlParameter("@id", intId) };
sqlcom.Parameters.AddRange(sqlParam);
sqlcom.ExecuteNonQuery(); //指定更新语句
}
}
/// <summary>
/// Repeater控件数据绑定时发生的事件
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
protected void userRepeat_ItemDataBound(object sender, RepeaterItemEventArgs e)
{
//判断Repeater控件中的数据是否是绑定的数据源，如果是的话将会验证是否进行了编辑操作
//ListItemType 枚举表示在一个列表控件可以包括，例如 DataGrid、 DataList和 Repeater 控件的不同项目。
if (e.Item.ItemType==ListItemType.Item || e.Item.ItemType==ListItemType.AlternatingItem)
{
//获取绑定的数据源，这里要注意上面使用sqlReader的方法来绑定数据源，所以下面使用的DbDataRecord方法获取的
//如果绑定数据源是DataTable类型的使用下面的语句就会报错.
System.Data.Common.DbDataRecord record = (System.Data.Common.DbDataRecord)e.Item.DataItem;
//DataTable类型的数据源验证方式
//System.Data.DataRowView record = (DataRowView)e.Item.DataItem;
//判断数据源的id是否等于现在的id，如果相等的话证明现点击了编辑触发了userRepeat_ItemCommand事件
if (id == int.Parse(record["id"].ToString()))
{
((Panel)e.Item.FindControl("plItem")).Visible = false;
((Panel)e.Item.FindControl("plEdit")).Visible = true;
}
else
{
((Panel)e.Item.FindControl("plItem")).Visible = true;
((Panel)e.Item.FindControl("plEdit")).Visible = false;
}
}
}
}
}
2、分页--PageDataSource
前台代码：使用原始的html文本，并添加了一个Literal标签，用来动态添加并指定html标签。
页面截图：
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<title></title>
<style type="text/css">
.pageBar
{
margin-top: 10px;
}
.pageBar a
{
color: #333;
font-size: 12px;
margin-right: 10px;
padding: 4px;
border: 1px solid #ccc;
text-decoration: none;
}
</style>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:Repeater ID="Repeater1" runat="server" >
<HeaderTemplate>
<table border="1" cellpadding="0" cellspacing="0" style="width:1006px;border-collapse:collapse; text-align:center;">
<tr>
<th style="background-color:red">ID</th>
<th style="background-color:red">内容</th>
</tr>
</HeaderTemplate>
<ItemTemplate>
<tr>
<td><asp:Label ID="lblId" runat="server" Text='<%# DataBinder.Eval(Container.DataItem,"id") %>' ></asp:Label></td>
<td><%# DataBinder.Eval(Container.DataItem,"name") %></td>
</tr>
</ItemTemplate>
<FooterTemplate>
</table>
</FooterTemplate>
</asp:Repeater>
</div>
<div class="pageBar">
<asp:Literal ID="ltlPageBar" runat="server"></asp:Literal>
</div>
</form>
</body>
</html>
后台代码：Repeater控件的数据源是PagedDataSource对象，在页面加载时为该对象动态指定了分页的属性，并使用Literal标签来动态指定每个标签跳转页的链接。
using System;
using System.Collections.Generic;
using System.Data;
using System.Data.SqlClient;
using System.Text;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
namespace WebApplication4
{
public partial class PageDemo : System.Web.UI.Page
{
private string id = "";
protected void Page_Load(object sender, EventArgs e)
{
if (!Page.IsPostBack)
{
//设置当前页的索引
int pageIndex = 1;
try
{
//获取当前索要跳转页的索引号
pageIndex = Convert.ToInt32(Request.QueryString["Page"]);
//如果是第0页将会跳转入第1页
if (pageIndex <= 0)
{
pageIndex = 1;
}
}
catch
{
pageIndex = 1;
}
DataTable dt = this.GetDataTable(); //获取绑定的数据表
PagedDataSource pds = new PagedDataSource(); //创建分页数据源对象
pds.DataSource = dt.DefaultView; //为数据源对象设置数据源
pds.AllowPaging = true; //对象允许分页
pds.PageSize = 2; //设置对象每页显示的大小
pds.CurrentPageIndex = pageIndex - 1; //设置数据源的当前页
//向Repeater控件上绑定分页数据源控件
this.Repeater1.DataSource = pds;
this.Repeater1.DataBind();
//使用Literal标签来动态指定每个标签跳转页的链接
ltlPageBar.Text = this.GetPageBar(pds);
}
}
/// <summary>
/// 获取每个标签上的跳转页的链接地址
/// </summary>
/// <param name="pds">分页数据源对象</param>
/// <returns>分页操作按钮的html文本</returns>
private string GetPageBar(PagedDataSource pds)
{
string pageBar = string.Empty; //声明页面标签文本
int currentPageIndex = pds.CurrentPageIndex + 1; //获取当前页索引
//判断首页的链接页面
if (currentPageIndex == 1) //如果该页为第一页，则证明它为首页
{
pageBar += "<a href=\"javascript:void(0)\">首页</a>";
}
else
{
//如果不是首页，首页链接的地址将会为1
pageBar += "<a href=\"" + Request.CurrentExecutionFilePath + "?Page=1\">首页</a>";
}
//判断上一页链接的地址
if ((currentPageIndex - 1) < 1) //如果上一页小于1则链接到第一页
{
pageBar += "<a href=\"javascript:void(0)\">上一页</a>";
}
else
{
//如果上一页地址不是1将会链接到上一页
pageBar += "<a href=\"" + Request.CurrentExecutionFilePath + "?Page=" + (currentPageIndex - 1) + "\">上一页</a>";
}
//指定下一页的链接地址
if ((currentPageIndex + 1) > pds.PageCount)
{
//如果下一页的地址大于总页数，将会连接到首页
pageBar += "<a href=\"javascript:void(0)\">下一页</a>";
}
else
{
//否则的话链接到下一页
pageBar += "<a href=\"" + Request.CurrentExecutionFilePath + "?Page=" + (currentPageIndex + 1) + "\">下一页</a>";
}
//指定末页的链接地址
if (currentPageIndex == pds.PageCount)
{
pageBar += "<a href=\"javascript:void(0)\">末页</a>";
}
else
{
pageBar += "<a href=\"" + Request.CurrentExecutionFilePath + "?Page=" + pds.PageCount + "\">末页</a>";
}
return pageBar; //返回html文本
}
/// <summary>
/// 获取数据源，重新链接数据
/// </summary>
/// <returns>DataTable，数据源</returns>
private DataTable GetDataTable()
{
DataTable dt = new DataTable(); //创建数据库表
using (SqlConnection con = new SqlConnection("server=.;DataBase=MyBlog;uid=sa;pwd=1;"))
{
con.Open(); //打开数据库链接
SqlCommand sqlCom = new SqlCommand(); //声明并创建数据库命令集
StringBuilder sqlStr = new StringBuilder(); //声明sql语句
sqlStr.Append("select * from match"); //获取sql语句
sqlCom.CommandText = sqlStr.ToString(); //为sqlcommand对象指定sql语句
sqlCom.Connection = con; //为sqlcommand对象指定链接对象
SqlDataAdapter sqlDa = new SqlDataAdapter(sqlCom); //声明数据库适配器
SqlCommandBuilder sqlBuilder = new SqlCommandBuilder(sqlDa);
sqlDa.Fill(dt); //填充表
}
return dt;
}
}
}
结语
文章主要介绍了Repeater控件的基本使用方法，并通过两个示例来更深一步的学习了Repeater控件的使用。虽然Repeater控件封装的操作较少，但它是最基础的数据绑定控件，另外可以通过使用其它控件来弥补Repeater控件的不足，如可以通过使用PagedataSource类来实现数据的分页。文章写到这里并没有结束，下篇文章将会着重讨论ListView。