Kentico 11 WebPart开发：如何实现n项列表的查询与输出？

嘿，我在Kentico 11里折腾过不少自定义WebPart，尤其是处理动态长度列表的场景，给你分享几个亲测好用的方案，应该能解决你的痛点：

这是我最常用的方案，完全不需要依赖页面类型，所有数据都在WebPart配置里管理，灵活度拉满：

• 第一步：创建WebPart时，在属性定义里加一个名为ListItems的属性，Form Control选Repeater。接着配置Repeater的子字段——比如你需要每个列表项有标题、链接、描述，就给Repeater添加对应的文本框、URL选择器等控件。
• 第二步：在WebPart的后台代码（.ascx.cs）里，读取ListItems的值——Kentico会把重复字段的数据以XML格式返回，你可以用CMS.Helpers.XmlHelper来解析，转换成自己定义的模型类列表。
• 第三步：把模型列表绑定到前端的Repeater或ListView控件上，写好ASCX模板渲染样式就行。

这个方案的好处是用户可以直接在WebPart配置界面添加/删除/编辑任意数量的项，不需要跳转到页面管理，适合单页面内的独立列表需求。

如果你的列表项需要在多个WebPart或页面里复用，或者需要更严谨的权限、版本管理，就用这个方案：

• 第一步：新建一个自定义模块（比如叫CustomListItems），在模块里定义一个ListItem数据类，对应数据库表，把你需要的字段（标题、内容、排序值等）加进去。Kentico会自动生成后台管理界面，方便你批量维护列表项。
• 第二步：在WebPart属性里添加一个UniSelector控件，设置它的数据源为你刚创建的ListItem类，并且开启“多选”模式。
• 第三步：在WebPart代码里，通过UniSelector返回的ID列表，用CMS.DataEngine.ObjectQuery查询对应的ListItem实例，转换成模型后渲染输出。

这个方案的优势是数据可以跨页面复用，后台管理更规范，适合数据量大或者需要统一维护的场景。

如果你之前尝试过容器页面类型但不满意，大概率是没做细节优化，调整一下就能用：

• 第一步：创建一个容器页面类型（比如ListContainer），再创建一个子页面类型ListItem，设置ListContainer为它的父页面类型。给ListItem添加你需要的字段，再加一个SortOrder字段用来控制排序。
• 第二步：在WebPart属性里加一个页面选择器，让用户选择目标ListContainer页面。
• 第三步：在WebPart代码里，用DocumentHelper.GetDocuments<ListItem>().WhereEquals("ParentDocumentID", 容器页面ID).OrderBy("SortOrder")来查询所有子页面，转换成模型后渲染。

优化点：可以在WebPart属性里加个复选框“只显示已发布项”，或者添加排序字段选择器，让用户更灵活地控制输出内容。

几个通用注意事项 #

• 性能优化：查询数据时一定要用Columns()指定需要的字段，避免拉取不必要的数据；如果列表项很多，记得加分页逻辑。
• 前端维护：尽量把渲染逻辑写在ASCX模板里，和后台代码分离，方便前端同事调整样式。
• 编辑预览：确保WebPart在编辑模式下能正确渲染数据，避免用户配置完看不到效果。

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