向 Web 窗体页添加 Repeater 控件

时间:2022-11-23 14:06:23

向页添加 Repeater Web 服务器控件需要若干步骤。下列过程描述创建一个工作的 Repeater 控件必须执行的最少步骤。

向 Web 窗体页添加 Repeater Web 服务器控件

  1. 向 Web 窗体页添加一个数据源。有多种方法可处理页上的数据。若要选择适当的方法,请参见 ADO.NET 数据访问介绍和对 Web 窗体页中数据访问的介绍。
  2. 在“设计”视图中,从“工具箱”的“Web 窗体”选项卡将 Repeater 控件拖到页面上。
  3. 设置控件的 DataSource 属性。在“属性”窗口中,DataSource 属性的下拉菜单中将显示所有数据源,例如在页上定义的 DataSetDataView 控件。
  4. 调用控件的 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();
    }
  5. 切换到“HTML”视图。
  6. Repeater 元素内创建包含 HTML 文本和控件的模板,以显示数据。有关详细信息,请参见 Web 服务器控件模板。有关 ItemTemplate 元素的主干可能会如下所示:
    <asp:repeater id=Repeater1 runat="server" datasource="<%# dataView1 >">   <ItemTemplate>   </ItemTemplate></asp:repeater>
  7. 向模板添加 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>