通过

Repeater 控件

  • 项目

Repeater 控件是一个容器控件，可用于从网页的任何可用数据中创建自定义列表。 Repeater 控件没有自己内置的呈现功能，这意味着您必须通过创建模板来提供 Repeater 控件的布局。当网页运行时， Repeater 控件会遍历数据源中的记录，并为每条记录呈现一个项。

由于 Repeater 控件没有默认的外观，因此可以使用该控件创建多种列表，其中包括：

  • 表格布局。

  • 逗号分隔的列表（例如，a, b, c, d 等）。

  • XML 格式的列表。

向网页中添加 Repeater 控件

  • 将 Repeater 控件从“工具箱”面板拖到网页上。

添加 Repeater 控件之后，可以为该控件指定数据源。

将 Repeater 控件绑定到数据源

  1. 在“设计”视图中，右键单击 Repeater 控件，然后单击“显示常用控制任务”。

  2. 在“DropDownList 任务”菜单上，单击“选择数据源”。

  3. 在“数据源配置向导”中，选择 Repeater 控件的数据源。有关详细信息，请参阅使用数据绑定控件配置数据源。

若要使用 Repeater 控件，请创建模板来定义该控件的内容布局。模板可以包含标记和控件的任意组合。如果未定义模板，或者如果所有模板都不包含元素，则当应用程序运行时，该控件不会显示在网页上。

为 Repeater 控件创建模板

  1. 在“代码”视图中，将插入点放置在 <asp:Repeater></asp:Repeater> 标记内。

  2. 按小于键 (<) 以打开代码完成下拉列表。

  3. 单击要创建的模板。

  4. 键入该模板所需的 HTML。有关模板定义的示例，请参阅 MSDN Library 中的如何：向 Web 窗体页添加 Repeater Web 服务器控件 Cc295084.xtlink_newWindow(zh-cn,Expression.40).png。

以下列表描述了 Repeater 控件支持的 Repeater 模板。

  • ItemTemplate： 包含要逐一呈现给数据源中的每个数据项的 HTML 元素和控件。

  • AlternatingItemTemplate： 包含要逐一呈现给数据源中的其他每个数据项的 HTML 元素和控件。通常，可以使用此模板为替代项创建不同的外观，例如指定一种不同于 ItemTemplate 中所指定颜色的背景色。

  • HeaderTemplate 和 FooterTemplate： 包含分别呈现在列表的开始和结束处的文本和控件。

  • SeparatorTemplate： 包含呈现在每项之间的元素。典型的示例可能是一条直线（使用 HR 元素）。

有关使用 Repeater 控件的其他信息，请参阅 MSDN Library 中的 Repeater Web 服务器控件概述 Cc295084.xtlink_newWindow(zh-cn,Expression.40).png。

另请参阅

概念

使用 ASP.NET 网站
DataList 控件
DetailsView 控件
FormView 控件
GridView 控件