ASP.NET WebForms（.NET Framework）动态Repeater控件入门实现方法咨询

阿华AIGC实验室

2026-3-26

嘿，作为常年和ASP.NET WebForms遗留项目死磕的老码农，我太懂你作为新手第一次碰动态Repeater的懵圈感了——这控件看着简单，刚上手确实容易踩坑。我给你把常见方法和最适合新手的实现步骤掰碎了讲，保证你跟着做就能跑起来。

一、动态Repeater的常见实现方法

针对初学者，优先掌握下面3种最实用的，复杂的先放一放：

内存集合直接绑定：新手入门首选！用List、ArrayList这类内存中的集合模拟数据，代码少、调试快，能快速理解Repeater绑定的核心逻辑，完全不用碰数据库，适合练手。
数据库数据源绑定：实际项目里的主流方案，又分两种场景：
- SqlDataSource：直接在前端页面配置连接字符串和SQL语句，不用写后端绑定代码，简单场景下效率极高。
- ObjectDataSource：更适合分层架构（比如有单独的业务逻辑层），把数据访问和业务逻辑封装起来，后端代码更整洁易维护。
手动生成Item（不推荐新手）：通过代码循环创建RepeaterItem，手动往里面加控件，步骤繁琐还容易出错，除非你有特殊定制需求，新手完全不用碰这个。

二、初学者的正确实现步骤（入门版）

我用「内存集合绑定爱好数据」做示例，这是最容易跑通的流程，先把基础逻辑搞懂，再去扩展数据库绑定的场景。

第一步：在ASPX页面定义Repeater的显示模板

Repeater本身没有默认的显示样式，必须你自己定义每个数据项的渲染模板，直接手写代码或者从工具箱拖控件都可以：

<!-- ASPX页面代码 -->
<asp:Repeater ID="rptHobbies" runat="server">
    <!-- 头部模板：可选，用来显示列表标题 -->
    <HeaderTemplate>
        <div class="hobby-container">
            <h2>我的爱好清单</h2>
        </div>
    </HeaderTemplate>
    <!-- 核心：每个数据项的显示模板 -->
    <ItemTemplate>
        <div class="hobby-item">
            <span>✨ 爱好名称：<%# Eval("Name") %></span>
            <span style="margin-left: 30px">描述：<%# Eval("Description") %></span>
        </div>
    </ItemTemplate>
    <!-- 尾部模板：可选，显示统计信息 -->
    <FooterTemplate>
        <div class="hobby-footer">
            共<%# ((List<Hobby>)rptHobbies.DataSource).Count %>项爱好
        </div>
    </FooterTemplate>
</asp:Repeater>

这里的<%# Eval("PropertyName") %>是数据绑定语法，用来把后端数据源里的属性值渲染到页面上，注意括号里的名称要和你后端实体类的属性完全对应。

第二步：后端准备数据源并绑定

先定义一个和数据对应的实体类（用来存每条爱好的数据）：

// 后端CS代码：可以放在当前页面的代码文件里，或者单独的实体类文件中
public class Hobby
{
    // 属性名称要和前端Eval里的名称完全一致！
    public string Name { get; set; }
    public string Description { get; set; }
}

在Page_Load事件里绑定数据，一定要加!IsPostBack判断，不然每次页面回发（比如点击按钮）都会重新绑定，导致数据重复或状态丢失：

protected void Page_Load(object sender, EventArgs e)
{
    // 只有第一次加载页面时才绑定数据
    if (!IsPostBack)
    {
        // 1. 准备数据源：这里用模拟数据，实际项目可以从数据库/接口获取
        List<Hobby> hobbyList = new List<Hobby>
        {
            new Hobby { Name = "篮球", Description = "每周打2次，最爱团队配合的感觉" },
            new Hobby { Name = "读书", Description = "沉迷科幻和历史类书籍" },
            new Hobby { Name = "敲代码", Description = "和遗留项目死磕的日常" }
        };

        // 2. 把数据源赋值给Repeater
        rptHobbies.DataSource = hobbyList;
        // 3. 触发绑定：这一步是核心，告诉Repeater根据模板渲染数据
        rptHobbies.DataBind();
    }
}