Repeater 控件使用总结

Repeater 控件使用总结

关于Repeater控件使用的一些总结，希望能对将来有机会看到这篇日志的同事有所帮助。

也是为了在自己开发有所遗忘的时候能够参考一下。

前言：

Repeater是一个迭代控件，什么是迭代控件呢？书本上的解释是这样的：如果一个ASP.NET数据绑定控件能够遍历一组数据，以将一个ASP.NET

模板应用于每一个数据项，则将这个ASP.NET数据绑定控件称为迭代控件。至于其与列表控件（DropDownList，ListBox，CheckBoxList等，

DataList除外）和视图控件（GridView，FormView，DetailsView等）的区别和比较在此就不赘述了。此处只是把Repeater这个控件做一个编程上的总结。
1，
首先，我们来预览一下Repeater空间的模板列表：

ItemTemplate
该模板确定了数据项的呈现样式

AlternatingItemplate

该模板也是用来确定数据项的实现样式，与ItemTemplate定义的样式交替显示，而且在ItemTemplate与AlternatingItemTemplate中定义相同的数据绑定控件时需要将ID属性设为一致。

HeaderTemplate
该模板确定了控件页眉的呈现样式

FooterTemplate
该模板确定了控件页脚的呈现样式

SeparatorTemplate
该模板定义了数据项间隔的呈现样式

DataSource
获取或设置IEnumerable数据源，为填充列表提供任何数据

DataMember

获取或设置绑定到该控件的DataSource中指定的表，平时所用较少（一般一个DataSoure中设置一个DataTable）。

DataSourceID

获取或设置数据源控件的名称，一般在以申明的方式指定数据源时使用，为填充列表提供任何数据。

Repeater控件通过枚举被绑定的数据源中的数据项来填充Items集合，数据源中包含的所有数据对象都将映射为一个RepeaterItem对象，并插入到Items集合中。

2，
RepeaterItem控件的属性

DataItem 返回绑定的数据对象，为绑定的Repeater项中返回NULL

ItemIndex 返回所呈现数据项的索引based 0

ItemType 返回Repeater呈现项的type包括（Header，Footer，Item，AlternatingItem，Separator）

2，Repeater数据绑定的实现

DataBind，

要想为Repeater控件生成HTML代码，并将其添加到输出流中以显示到最终的浏览器中，必须调用DataBind方法。此外Repeater控件还提供了一下常用事件。

ItemCommand

该事件是Repeater中最常用的一个事件，单击Repeater控件中的按钮（Button或LinkButton）时触发该事件。

ItemCreate
在创建一个Repeater项时触发该事件，DataItem属性总是返回NULL

ItemDataBind

将Repeater控件中的某个项绑定到基层数据以后触发该事件，ItemTemplate和AlternatingItemTemplate绑定项的DataItem属性不为NULL

3，动态定制实现样式呈现

在数据绑定之后需要生成HTML输出，这可以套用实现在各种Template中定制的模板，也可以更具绑定的数据动态生成HTML的样式输
出。因此数据项的信息就需要作为动态生成HTML时候的输入参数，Container很好的提供这项功能。在生成HTML的函数中可以使用
DataBinder.GetPropertyValue(Container.DataItem,"XXX");来得到指定数据对象（即该
Container.DataItem）的指定属性的值。但前提是该属性需要申明为public并且至少有get访问器。否则将不起作用（例如
该属性实现为一个字段）。一般.NET Framework 2.0
实现的数据源控件都符合上述的要求。只有在定制自己的数据源控件时才需要注意上述问题。

举例：
<ItemTemplate><%#
GetStyleForItem(Container)%></ItemTemplate>
public string GetStyleForItem(Control dataObj)//public
是必须的

{

string value =
DataBinder.GetPropertyValue(dataObj.DataItem,"XXX");

}

4,获取子控件进行编程处理

获取子控件有两种方法可用：
1，将Container作为参数传到后台函数中。

例如：<ItemTemplate><%#m_checkbox
=
(CheckBox)GetCheckBox(Container)%></ItemTemplate>

public CheckBox GetCheckBox(Control container)

{

return
(CheckBox)container.FindControl("DontrolID");

}

2,利用postback事件---ItemCommand来实现

protected void Repeater1_ItemCommand(object
source,RepeaterCommandEventArgs e)

{

if(e.CommandName=="checkbox")//如果未指定CommandName属性则也可以用CommandSourc.Text属性。

CheckBox a =
(CheckBox)e.Item.FindControl("ControlID");

//处理a控件。

}