Kentico CMS Repeater WhereCondition动态路径导致DocumentURLPath错误问题

1. 优先使用内置Path属性替代WhereCondition做路径过滤 #

CMSRepeater 内置的Path属性专门用于文档路径匹配，会自动处理转义、多站点、多语言适配，比手动在WhereCondition中写NodeAliasPath匹配逻辑更稳定。
不要在 ascx 文件中通过绑定表达式赋值路径属性，容易因页面生命周期顺序问题，导致赋值晚于 Repeater 数据加载时机，出现过滤失效。直接在后台代码赋值：

// 你的动态获取父路径方法，测试已返回正确值
string parentAliasPath = GetParentDocumentAliasPath();
// 匹配父路径下所有层级子文档，包含 Downloads 子目录
yourCmsRepeater.Path = $"{parentAliasPath}/%";
// 如果只需要匹配父路径的直接子级，替换为 $"{parentAliasPath}/*"

2. 确保赋值时机符合页面生命周期 #

把 Repeater 配置逻辑放在OnInit或OnLoad阶段执行，早于控件默认的数据绑定时机：

protected override void OnInit(EventArgs e)
{
    base.OnInit(e);
    // 直接取当前文档别名路径，不需要额外写方法获取
    string currentDocPath = DocumentContext.CurrentDocument.NodeAliasPath;
    string targetDownloadPath = $"{currentDocPath}/Downloads/%";
    
    yourCmsRepeater.Path = targetDownloadPath;
    yourCmsRepeater.ClassNames = "自定义下载类的CodeName";
    
    // 若必须使用WhereCondition写路径规则，一定要做转义处理
    // yourCmsRepeater.WhereCondition = $"NodeAliasPath LIKE N'{SqlHelper.EscapeLikeText(targetDownloadPath)}'";
}

注意：手动写WhereCondition的路径匹配时，必须用SqlHelper.EscapeLikeText处理路径字符串，避免路径中包含下划线、百分号等LIKE语法特殊字符，导致匹配结果不符合预期。

3. 修正URL输出逻辑 #

如果路径过滤正确后DocumentUrlPath仍输出错误，优先使用官方推荐的URL生成方式，自动适配站点重写规则、多语言配置：

<%-- 不要直接Eval("DocumentUrlPath")输出 --%>
<a href='<%# DocumentURLProvider.GetUrl(Convert.ToInt32(Eval("NodeID"))) %>'>
    <%# Eval("DocumentName") %>
</a>

同时检查两个控件属性配置：

• 不需要多语言回退的场景，将CombineWithDefaultCulture设为false
• 开启了控件缓存的场景，缓存名需要关联当前文档ID，避免不同页面的缓存互相干扰：

  yourCmsRepeater.CacheItemName = $"DownloadsRepeater_{DocumentContext.CurrentDocument.NodeID}";
  

4. 快速调试定位方法 #

如果问题仍存在，在赋值完成后、数据绑定前打印属性值和硬编码的正确值对比，可直接在 Kentico 后台事件日志中查看结果：

CMSEventLog.LogInformation("RepeaterDebug", "PathCheck", 0, 
    $"动态路径：{yourCmsRepeater.Path}, 正确硬编码路径：/你的/硬编码/路径/%");

内容的提问来源于stack exchange，提问作者user17378253