Asp.net Repeater控件

Repeater控件和DataList控件，可以用来一次显示一组数据项。比如，可以用它们显示一个数据表中的所有行。 
    Repeater控件完全由模板驱动，提供了最大的灵活性，可以任意设置它的输出格式。DataList控件也由模板驱动，和Repeater不同的是，DataList默认输出是HTML表格，DataList将数据源中的记录输出为HTML表格一个个的单元格。

1. Repeater控件显示数据

要使用Repeater控件显示数据，必须创建ItemTemplate。如下所示： 
例1：使用ItemTemplate显示数据

<asp:Repeater ID="Repeater1" runat="server" DataSourceID="SqlDataSource1">
    <ItemTemplate>
        <div class="movies">
            <h1><%#Eval("Title") %></h1>
        </div>
        <b>Directed by:</b><%#Eval("Director") %>
        <br />
        <b>Description:</b><%#Eval("Description") %>
    </ItemTemplate>
</asp:Repeater> 

以上代码，通过浏览器可以看到，.net不会改变里面的结构，模板里面怎么排列，数据显示也怎么样显示。它的HTML如下所示：、

<div class="movies">
     <h1>史密斯行动</h1>
</div>
<b>Directed by:</b>Doug Liman
<br />
<b>Description:</b>约翰（布拉德?皮特 Brad Pitt 饰）和
<div class="movies">
     <h1>暴力街区</h1>
</div>
<b>Directed by:</b>Luc Besson
<br />
<b>Description:</b>卧虎藏龙而又凌乱不堪的13区… 

所以，Repeater的灵活性就在这个上面，完全可以自由发挥，想怎么显示就怎么显示。例如，都可以把它放在Javascript代码中

<script type=”text/javascript”>
    <asp:Repeater id=”rptPhotos” Runat=”server”>
         <ItemTemplate>
              <%# Eval(“Name”, "photos.push(‘Photos/{0}’)") %>
         </ItemTemplate>
    </asp:Repeater>
</script> 

以上，photos是一个Javscript数组对象。Repeater生成的数据，最后就像以下这样：

<script type="text/javascript">
        photos.push('Photos/1.jpg');
        photos.push('Photos/2.jpg');
        photos.push('Photos/3.jpg');
        photos.push('Photos/4.jpg');
        …
</script> 

2. Repeater中使用模板

Repeater支持以下5种模板 
      ● ItemTemplate : 对每一个数据项进行格式设置 【Formats each item from the data source.】 
      ● AlternatingItemTemplate : 对交替数据项进行格式设置 
      ● SeparatorTemplate : 对分隔符进行格式设置 
      ● HeaderTemplate : 对页眉进行格式设置 
      ● FooterTemplate : 对页脚进行格式设置 
   以上，英文中使用了Formats item from datasource这样的话，就说明Repeater控件主要是用来对数据进行Format的，控制数据怎么样排列，怎么样显示。 
   Repeater必须使用的是Itemtemplate，其它的类型模板按需添加。 
例2：以下通过CSS控制，显示了一个比较不错的列表项：

<style type="text/css">
    html {
        background-color:Silver
    }
    .content {
        width:600px;
        border:soild 1px black;
        background-color:White;
    }
    .movies {
        border-collapse:collapse;
    }
    .movies th,.movies td {
        padding:10px;
        border-bottom:1px solid black;
    }
    .alternating {
        background-color:#eeeeee;
        }
</style>

<div class="content">
<asp:Repeater ID="Repeater1" runat="server" DataSourceID="SqlDataSource1">
    <HeaderTemplate> <!-- 显示头部 -->
        <table class="movies"> <!-- table头部声明-->
         <tr>
            <th>Movie Title</th>
            <th>Movie Director</th>
            <th>Box Office Totals</th>
         </tr>
    </HeaderTemplate>
    <ItemTemplate>  <!-- 数据行 -->
        <tr>
            <td><%#Eval("Title") %></td>
            <td><%#Eval("Director") %></td>
            <td><%#Eval("BoxOfficeTotals","{0:c}") %></td> <!-- 格式化为货币形式 -->
        </tr>
    </ItemTemplate>
    <AlternatingItemTemplate> <!-- 交错行 -->
        <tr class="alternating">
            <td><%#Eval("Title") %></td>
            <td><%#Eval("Director") %></td>
            <td><%#Eval("BoxOfficeTotals","{0:c}") %></td>
        </tr>
    </AlternatingItemTemplate>
    <FooterTemplate> <!-- 脚注行 -->
        </table>    <!-- table尾 -->
    </FooterTemplate>
</asp:Repeater>
</div> 

以上，显示的样式如下所示：

3. Repeater控件的事件处理

Repeater控件有以下事件： 
      ● DataBinding : Repeater控件绑定到数据源时触发 
      ● ItemCommand : Repeater控件中的子控件触发事件时触发 
      ● ItemCreated : 创建Repeater每个项目时触发  
      ● ItemDataBound : Repeater控件的每个项目绑定数据时触发 
例3：使用Repeater控件的事件支持编辑、更新、删除 
=== 后台代码 ===

<script runat=”server”>
    // The name of the primary key column
    string DataKeyName = "Id";

    /// 把每个列的ID存储在ViewState["Keys"]对象中，ViewState["Keys"]是一个HashTable对象。
    Hashtable Keys
    {
        get
        {
            if (ViewState["Keys"] == null)
                ViewState["Keys"] = new Hashtable();
            return (Hashtable)ViewState["Keys"];
        }
    }

    /// Repeater控件绑定到数据源时触发
    /// 每次更新，删除，增加后，都会触发这个事件，Keys中的值都会被清除。
    /// 在ItemDataBound事件发生时，被新的值填充
    protected void rptMovies_DataBinding(object sender, EventArgs e)
    {
        Keys.Clear();
    }

    /// 每个项目绑定数据时触发
    protected void rptMovies_ItemDataBound(object sender, RepeaterItemEventArgs e)
    {
        // 如果是数据列，把ID列取出来，加入到ViewState["Keys"]中
        // DataBinder.Eval是在运行时计算数据绑定表达式。这样的用法要记住.
        if (e.Item.ItemType == ListItemType.Item || e.Item.ItemType ==ListItemType.AlternatingItem)
        {
            Keys.Add(e.Item.ItemIndex, DataBinder.Eval(e.Item.DataItem, "Id"));
        }
    }

    /// 当点击Update,Insert,Delete按钮时触发
    protected void rptMovies_ItemCommand(object source, RepeaterCommandEventArgs e)
    {
        switch (e.CommandName)
        {
            case "Update":
                UpdateMovie(e);
                break;
            case "Insert":
                InsertMovie(e);
                break;
            case "Delete":
                DeleteMovie(e);
                break;
        }
    }
    /// Update a movie record
    protected void UpdateMovie(RepeaterCommandEventArgs e)
    {
        // 从一个数据项中获得相应的控件
        TextBox txtTitle = (TextBox)e.Item.FindControl("txtTitle");
        TextBox txtDirector = (TextBox)e.Item.FindControl("txtDirector");
        CheckBox chkInTheaters = (CheckBox)e.Item.FindControl("chkInTheaters");
        // 填充sqlDataSource的UpdateParameters值
        srcMovies.UpdateParameters["Id"].DefaultValue =
        Keys[e.Item.ItemIndex].ToString();
        srcMovies.UpdateParameters["Title"].DefaultValue = txtTitle.Text;
        srcMovies.UpdateParameters["Director"].DefaultValue = txtDirector.Text;
        srcMovies.UpdateParameters["InTheaters"].DefaultValue =
        chkInTheaters.Checked.ToString();
        // 进行Update
        srcMovies.Update();
    }

    /// Insert a movie record
    protected void InsertMovie(RepeaterCommandEventArgs e)
    {
        // 从一个数据项中获得相应的控件
        TextBox txtTitle = (TextBox)e.Item.FindControl("txtTitle");
        TextBox txtDirector = (TextBox)e.Item.FindControl("txtDirector");
        CheckBox chkInTheaters = (CheckBox)e.Item.FindControl("chkInTheaters");
        // 填充sqlDataSource的InsertParameters值
        srcMovies.InsertParameters["Title"].DefaultValue = txtTitle.Text;
        srcMovies.InsertParameters["Director"].DefaultValue = txtDirector.Text;
        srcMovies.InsertParameters["InTheaters"].DefaultValue =
        chkInTheaters.Checked.ToString();
        // Fire the InsertCommand
        srcMovies.Insert();
    }

    /// Delete a movie record
    protected void DeleteMovie(RepeaterCommandEventArgs e)
    {
        // 设置sqlDataSource的DeleteParameters值
        srcMovies.DeleteParameters["Id"].DefaultValue =  Keys[e.Item.ItemIndex].ToString();
        // Fire the DeleteCommand
        srcMovies.Delete();
    }
</script> 

=== 前台页面 ===

<asp:Repeater id="rptMovies" DataSourceID="srcMovies" Runat="server"
      OnItemCommand="rptMovies_ItemCommand" OnItemDataBound="rptMovies_ItemDataBound" OnDataBinding="rptMovies_DataBinding">
    <HeaderTemplate>
        <table class="movies">
        <tr> <th>Title</th><th>Director</th><th>In Theaters</th> </tr>
    </HeaderTemplate>
    <ItemTemplate>
        <tr>
            <td><asp:TextBox id="txtTitle" Text='<%#Eval("Title")%>' Runat="server" /></td>           
            <td><asp:TextBox id="txtDirector" Text='<%#Eval("Director")%>' Runat="server" /></td>
            <td><asp:CheckBox id="chkInTheaters" Checked='<%#Eval("InTheaters")%>'Runat="server" /></td>
            <td><asp:LinkButton id="lnkUpdate" CommandName="Update" Text="Update" Runat="server" />
                &nbsp;|&nbsp;<asp:LinkButton id="lnkDelete" CommandName="Delete" Text="Delete"
                                  OnClientClick="return confirm(‘Are you sure?');" Runat="server" /></td>
        </tr>
    </ItemTemplate>
    <FooterTemplate>
        <tr>
            <td><asp:TextBox id="txtTitle" Runat="server" /></td>
            <td><asp:TextBox id="txtDirector" Runat="server" /></td>
            <td><asp:CheckBox id="chkInTheaters" Runat="server" /></td>
            <td><asp:LinkButton id="lnkInsert" CommandName="Insert" Text="Insert" Runat="server" /></td>
        </tr>
        </table>
    </FooterTemplate>
</asp:Repeater>

<asp:SqlDataSource id="srcMovies" ConnectionString="<%$ ConnectionStrings:Movies %>"
    SelectCommand="SELECT Id,Title,Director,InTheaters FROM Movies"
    UpdateCommand="UPDATE Movies SET Title=@Title,Director=@Director,InTheaters=@InTheaters WHERE Id=@Id"
    InsertCommand="INSERT Movies(Title,Director,InTheaters) VALUES(@Title,@Director,@InTheaters)"
    DeleteCommand="DELETE Movies WHERE Id=@Id" Runat="server">
    <UpdateParameters>
        <asp:Parameter Name="Id" />
        <asp:Parameter Name="Title" />
        <asp:Parameter Name="Director" />
        <asp:Parameter Name="InTheaters" />
    </UpdateParameters>
    <InsertParameters>
        <asp:Parameter Name="Title" />
        <asp:Parameter Name="Director" />
        <asp:Parameter Name="InTheaters" />
    </InsertParameters>
    <DeleteParameters>
        <asp:Parameter Name="Id" />
    </DeleteParameters>
</asp:SqlDataSource>