向页添加 Repeater Web 服务器控件需要若干步骤。下列过程描述创建一个工作的 Repeater 控件必须执行的最少步骤。
向 Web 窗体页添加 Repeater Web 服务器控件
向 Web 窗体页添加一个数据源。有多种方法可处理页上的数据。若要选择适当的方法,请参见 ADO.NET 数据访问介绍和对 Web 窗体页中数据访问的介绍。 在“设计”视图中,从“工具箱”的“Web 窗体”选项卡将 Repeater 控件拖到页面上。 设置控件的 DataSource 属性。在“属性”窗口中,DataSource 属性的下拉菜单中将显示所有数据源,例如在页上定义的 DataSet 和 DataView 控件。 调用控件的 DataBind 方法。通常使用如下所示代码在该页的 Page_Load 事件中完成此操作,此处 Repeater1 控件绑定到 DataSet 对象。由于 DataSet 已在设计器中绑定到 Repeater 控件,所以它不需要在该代码中进行绑定: ' Visual Basic
Protected Sub Page_Load(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles MyBase.Load
' Put user code to initialize the page, including data, here.
Repeater1.DataBind()
End Sub
// C#
protected void Page_Load(object sender, EventArgs e)
{
// Put user code to initialize the page, including data, here.
Repeater1.DataBind();
}
切换到“HTML”视图。 在 Repeater 元素内创建包含 HTML 文本和控件的模板,以显示数据。有关详细信息,请参见 Web 服务器控件模板。有关 ItemTemplate 元素的主干可能会如下所示: <asp:repeater id=Repeater1 runat="server" datasource="<%# dataView1 >">
<ItemTemplate>
</ItemTemplate>
</asp:repeater>
向模板添加 HTML 元素和 Web 服务器控件的任意组合以显示数据源信息。 必须通过包括一个数据绑定表达式将控件绑定到数据。通常,将它们绑定到容器控件。显示数据源中每行的“EmployeeName”和“PhoneNumber”字段的 ItemTemplate 元素将类似如下所示:
<ItemTemplate>
<%# DataBinder.Eval(Container, "DataItem.EmployeeName") %>
<%# DataBinder.Eval(Container, "DataItem.PhoneNumber") %>
<br>
</ItemTemplate>
有关详细信息,请参见 Web 窗体页中的数据访问。
下面的示例说明一个完整的 Repeater 控件定义在“HTML”视图中应类似于什么样子。指定将 Repeater 控件呈现为表。<table> 元素在 HeaderTemplate 中开始并在 FooterTemplate 中结束。(“任务列表”将报告有关这种情况的错误,但是这些错误可以安全地忽略,在运行应用程序时,该表将正确地显示。)在 Repeater 控件体内,表单元格用于显示数据源的列。除了表单元格的背景色不同以创建带状效果外,AlternatingItemTemplate 元素与 ItemTemplate 项相同。
<asp:Repeater id=Repeater1 runat="server" DataSource="<%# DataView1%>">
<HeaderTemplate>
<table width="100%" style="font: 8pt verdana">
<tr style="background-color:DFA894">
<th> First Name </th>
<th> Last Name </th>
</tr>
</HeaderTemplate>
<ItemTemplate>
<tr>
<td><%# DataBinder.Eval(Container, "DataItem.EmployeeName") %>
</td>
<td><%# DataBinder.Eval(Container,"DataItem.PhoneNumber") %>
</td>
</tr>
</ItemTemplate>
<AlternatingItemTemplate>
<tr>
<td bgcolor="lightblue">
<%# DataBinder.Eval(Container, "DataItem.EmployeeName") %> </td>
<td bgcolor="lightblue">
<%# DataBinder.Eval(Container,"DataItem.PhoneNumber") %> </td>
</tr>
</AlternatingItemTemplate>
<FooterTemplate> </table> </FooterTemplate>
</asp:Repeater>
下面的示例使用标签 (Label) 控件显示数据库的值。使用分隔符模板创建列表中值之间的分隔符。请注意,Label 控件的 Text 属性的值包含在单引号中。属性值通常放在双引号中,但是由于 DataBinder 调用包含双引号,所以 Text 属性值必须括在单引号中。
<asp:Repeater id="Repeater1" runat="server" DataSource="<%# DataView1%>">
<ItemTemplate>
<asp:Label id=Label1 runat="server"
Text='<%# DataBinder.Eval(Container, "DataItem.EmployeeName")%>'>
</asp:Label>
</ItemTemplate>
<SeparatorTemplate>,</SeparatorTemplate>
</asp:Repeater>