数据绑定控件之Repeater

Posted 2020-09-20 杨铭宇

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了数据绑定控件之Repeater相关的知识，希望对你有一定的参考价值。

引言

前几篇的文章在说AJAX的内容，利用AJAX技术能够开发出高效运行的网站应用程序，不过在进行B/S项目开发时只拥有AJAX技术是远远不够的，踏入到B/S要学的东西会更多，但相较C/S的复杂逻辑结构来说B/S在开发时还是很简单的。

在开发B/S项目时，常常会用到数据绑定控件，.NET平台已经对这些控件进行了良好的封装，只要稍有经验的程序猿很快就能够上手使用这些数据控件，所以接下来的几篇文章将会讨论数据控件，首先将会从数据控件的细节入手讨论ListView、GridView、Repeater、DataList控件的基本使用方法，并在会后系列文章的最后对这几个控件进行综合性的分析总结。

技术分享

一、绑定控件之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="">
<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 [email protected]"; //为命令对象指定执行语句
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 [email protected] where [email protected]"; //为命令对象指定执行语句
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="ID</th>
<th style="内容</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 控件的嵌套使用

.net(c#)Repeater控件问题

Repeater中 DropDownList如何绑定数据

动态创建的Repeater为啥绑定数据只显示一条

c#中关于repeater控件的说法

Repeater使用方法---基础数据绑定+多级嵌套