【发布时间】：2011-07-25 14:44:58
【问题描述】：
用于调用 ContentItem 驱动程序的方法 IContentManager.BuildDisplay 有一个可选的 groupId 参数。
我浏览了源代码，但我不明白它的用例到底是什么。它似乎能够过滤形状，但我不确定我是否理解。
你能帮我澄清一下吗？提前致谢。
【问题讨论】：
标签： c# .net asp.net asp.net-mvc orchardcms
【发布时间】：2011-07-25 14:44:58
【问题描述】：
是的，此参数用于过滤形状。您可以通过驱动程序的 Display/Editor 方法返回的 ContentShape 对象的 .OnGroup() 方法提供可选参数。
默认情况下它是一个空字符串。如果您在 BuildDisplay 中提供 groupId 参数 - 在构建最终输出时，只会考虑具有指定组 ID 的形状。
我发现它在需要在不同场景中以不同方式呈现同一部分时特别有用 - 返回一个 Combined 结果，其中包含 ContentShape 对象（每个对象都指定了不同的组）来自驱动程序的 Display 方法。
请记住，如果您在 BuildDisplay 方法中明确指定一个组 - 仅将使用具有该组集的形状。
【讨论】：
-
是的。如果我没记错的话，这个组目前用于处理管理页面中的选项卡。
-
非常感谢。这将证明非常有用。
-
@Bertrand：你说得对 - 它目前用于处理 Dashboard 中的站点设置菜单子项。
-
是否可以将此分组应用于字段？我尝试在包含字段的部件上使用 OnGroup，但只显示部件编辑器，而不是字段（这很有意义，因为它们使用不同的驱动程序）。
-
调用 .OnGroup(x) 是否与在 Placement.info 中指定 @MyGroup 相同？