Orchard的IContentManager.BuildDisplay方法中的groupId参数是什么？

Question

用于调用ContentItem驱动程序的方法IContentManager.BuildDisplay具有可选的groupId参数。 我已经浏览了源代码，但我并不确切地知道它的用例是什么。它似乎能够过滤形状，但我不确定我是怎么理解的。

你能为我澄清一下吗？提前谢谢。

Answer 1

是的，此参数用于过滤形状。您可以通过从驱动程序的Display / Editor方法返回的ContentShape对象的 .OnGroup（）方法提供可选参数。

默认情况下，它是一个空字符串。如果在BuildDisplay中提供groupId参数 - ，则在构建最终输出时，只会考虑指定了具有该组ID的形状。

我发现在需要在不同场景中以不同方式呈现相同部分时特别有用 - 在其中返回 Combined 结果与ContentShape对象（每个对象具有不同的组）从驱动程序的显示方法。

请记住，如果您在BuildDisplay方法中明确指定了一个组 - 仅，则将使用具有该组集的形状。