报表控件Stimulsoft Reports中创建主从报告时的一些更改

Stimulsoft Ultimate （原Stimulsoft Reports.Ultimate）是用于创建报表和仪表板的通用工具集。该产品包括用于WinForms、ASP.NET、.NET Core、JavaScript、WPF、PHP、Java和其他环境的完整工具集。无需比较产品功能，Stimulsoft Ultimate包含了所有内容！

Stimulsoft Reports.Ultimate不仅拥有强大的报表导出系统，而且还支持多种报表导出格式，拥有简单且强大的报表引擎。Stimulsoft Reports.Ultimate基本原则是，用简单常规的方法创建报表，将不同的技术应用于应用程序。

Stimulsoft Reports官方正版下载（qun：740060302 ）https://www.evget.com/product/2398/download  

什么是主从报告？

主-详细信息是一种报表类型，其中数据相互关联并组织成多个级别：一个主带数据记录对应于多个详细数据带记录。换句话说，Master-Detail报表是一个有详细信息的数据，比如按类别展示数据的报表：

在上面的查看器中，我们看到一个标准示例：首先显示有关每个产品类别的信息，然后显示属于该类别的产品列表。

主从报告结构

我们的产品提供了两种在主从报告中确定条带相对位置的方法。

第一种方法是将 Detail 区域放置在 Master 区域之后：

第二种方法是将 Detail 区域放置在 Master 区域内；在这种情况下，我们将其称为嵌套细节带。

组件用作其他元素的容器。您可以将一个或多个元素放置在一个面板上。只有交叉带可以直接放置在其他带上；其他带子只能放置在容器中。

上述两种放置带的方法的作用相同。选项的选择仅取决于您希望获得的报告的外观。在实践中，当详细信息部分的数据量较少时，通常会选择第二个选项。

构建主从报告的特点

文章开头的报告样本展示了所谓的“理想情况”，即所有类别都包含产品数据。然而，在实际数据中，某些类别可能不包含任何产品。因此，类别详细信息中可能没有任何内容可显示。

在实践中，通常不需要显示空类别。因此，默认情况下，我们的引擎隐藏它们。但是，用户可以选择是否显示空类别。他们可以使用主带属性“如果详细信息为空则打印”来执行此操作。如果该属性的值设置为true，则主带的所有记录都将被打印，无论它们是否有详细数据。

PrintIfDetailEmpty 属性操作的更改

让我们继续本文的主题。从版本2023.2开始， PrintIfDetailEmpty属性的逻辑已得到增强。以前，该属性仅适用于位于主带之后的详细带。现在，该属性还对位于主带内的细节带进行操作。

笔记！以前，无论主区域的PrintIfDetailEmpty

属性的值如何，在任何情况下都会显示嵌套的详细信息区域。因此，如果主带的属性已设置为 true，则不会发生任何变化；详细信息带将像以前一样显示。

从技术上讲，嵌套带区始终被视为细节带区，无论它们是否设置了 MasterComponent 属性。但是，由于PrintIfDetailEmpty属性之前对它们没有影响，因此用户没有意识到这一点。

因此，此修改可能会影响某些具有嵌套带区的报表，这些报表最初不是作为主从报表创建的。如果嵌套带区没有数据，则主带区也不会显示。

解决方案

如果您的报告中出现上述问题，您可以通过以下方式之一解决：

• 对于包含其他嵌套带区的带区，将PrintIfDetailEmpty属性的值设置为true ；
  
• 从应用程序代码设置静态属性的值。

StiOptions.Engine.CheckForEmptyNestedDetail=false

如果问题影响大量报告，或者您没有时间更改报告，则可以使用第二个选项。但是，它会影响所有报告。如果在报告中，您需要删除主带，并且它没有详细信息，您仍然需要使用第一个选项，这将需要在每个报告中进行更改。

另请注意，引入StiOptions的某些属性只是为了确保与旧版本的向后兼容性。有一天，在下一次重大重构期间，这些属性可能会被标记为“已过时”，并在几年后被删除。