ASP.NET Repeater控件不显示求助：无报错未渲染网站列表

阿华AIGC实验室

2026-5-27

排查Repeater控件不显示内容的问题

咱们一步步拆解可能的问题，先从你的ASPX标记里最明显的错误说起：

1. ASPX页面Repeater结构错误（核心问题）

你把<ItemTemplate>放在了<asp:Repeater>标签的外面，这会导致Repeater完全无法识别模板规则，自然不会渲染任何内容。正确的写法必须把模板嵌套在Repeater控件内部，修正后的代码如下：

<div>
    <asp:Repeater ID="Rpt1" Visible="true" runat="server">
        <ItemTemplate>
            <asp:HyperLink runat="server" 
                Text='<%# DataBinder.Eval(Container.GetDataItem(), "Key") %>' 
                NavigateUrl='<%# DataBinder.Eval(Container.GetDataItem(), "Value") %>'>
            </asp:HyperLink>
        </ItemTemplate>
    </asp:Repeater>
</div>

另外，数据绑定语法可以简化，Eval()是更常用且简洁的写法，和你原来的代码等价：

Text='<%# Eval("Key") %>' 
NavigateUrl='<%# Eval("Value") %>'

2. 后台数据源绑定逻辑检查

即使ASPX结构正确，后台如果没做好绑定，控件也不会显示内容，需要确认以下几点：

是否给Repeater指定了数据源：你需要准备一个包含Key和Value属性的集合（比如Dictionary<string, string>、自定义实体列表等），并赋值给Rpt1.DataSource。
是否调用了DataBind()方法：赋值数据源后必须调用Rpt1.DataBind()，这是触发数据渲染的关键步骤，缺了这一步Repeater不会生成任何内容。
数据源是否为空：如果你的数据源是空集合（比如数据库查询无结果），Repeater自然没有内容可显示，可以给Repeater添加<EmptyDataTemplate>来提示无数据，或者后台先判断数据源是否为空再绑定。

举个后台绑定的示例（用Dictionary模拟数据源）：

protected void Page_Load(object sender, EventArgs e)
{
    if (!IsPostBack)
    {
        // 模拟网站列表数据源
        var siteList = new Dictionary<string, string>
        {
            { "Google", "https://www.google.com" },
            { "Stack Overflow", "https://stackoverflow.com" }
        };
        Rpt1.DataSource = siteList;
        Rpt1.DataBind(); // 这一步绝对不能少！
    }
}