Repeater 类

一个数据绑定列表控件,允许通过为列表中显示的每一项重复指定的模板来自定义布局。

命名空间:  System.Web.UI.WebControls
程序集:  System.Web(在 System.Web.dll 中)

备注


Repeater 控件是一个基本模板数据绑定列表。它没有内置的布局或样式,因此必须在该控件的模板内显式声明所有的布局、格式设置和样式标记。

Repeater 控件是唯一允许在模板间拆分标记的 Web 控件。若要利用模板创建表,请在 HeaderTemplate 中包含表开始标记 (<table>),在 ItemTemplate 中包含单个表行标记 (<tr>),并在 FooterTemplate 中包含表结束标记 (</table>)。

Repeater 控件没有内置的选择功能和编辑支持。可以使用 ItemCommand 事件来处理从模板引发到该控件的控件事件。

Repeater 控件提供两个属性以支持数据绑定。若要将数据绑定到实现 System.Collections.IEnumerable 接口(如System.Data.DataViewSystem.Collections.ArrayListSystem.Collections.Hashtable 或数组)或 IListSource 接口的任意对象,请使用 DataSource 属性指定数据源。在设置 DataSource 属性时,必须手动编写代码才能执行数据绑定。若要将 Repeater 控件自动绑定到由数据源控件表示的数据源,请将 DataSourceID 属性设置为要使用的数据源控件的 ID。在设置 DataSourceID 属性时,Repeater 控件自动绑定到第一个请求上指定的数据源控件。因此,除非更改了 Repeater 控件的与数据相关的属性,否则不必显式调用 DataBind 方法。

Repeater 控件将其 ItemTemplate 和 AlternatingItemTemplate 绑定到由其 DataSource 属性声明和引用的数据模型,或绑定到由其 DataSourceID 属性指定的数据源控件。HeaderTemplate、 FooterTemplate 和 SeparatorTemplate 都未进行数据绑定。

如果设置了 Repeater 控件的数据源但未返回数据,该控件将呈现不带项的 HeaderTemplate 和 FooterTemplate。如果数据源为 null,则不呈现 Repeater

每个 Repeater 控件必须至少定义一个 ItemTemplate。但是,下表中描述的其他可选模板可用来自定义列表的外观。

 

 

http://msdn.microsoft.com/zh-cn/library/system.web.ui.webcontrols.repeater.aspx

http://support.microsoft.com/default.aspx?scid=kb;EN-US;306154  work well@!@!

 


原文地址:https://www.cnblogs.com/xfiver/p/1729610.html