Stimulsoft Ultimate （原Stimulsoft Reports.Ultimate）是用于創建報表和儀表板的通用工具集。該產品包括用于WinForms、ASP.NET、.NET Core、JavaScript、WPF、PHP、Java和其他環境的完整工具集。無需比較產品功能，Stimulsoft Ultimate包含了所有內容！

有時，人們會聯系我們的技術支持，詢問一個常見問題：如何正確地將多份報告合并為一份，尤其是在導出之前。雖然這在技術上很簡單，但仍有一些選項需要考慮。例如，在合并報告時如何管理不同的度量單位或頁碼。沒有通用的解決方案，因為它取決于報告創建者的具體目標和目的。為了說明如何將多份報告合并為一份，我們為JS和.NET開發了幾個示例。

Stimulsoft Reports官方正版下載   

MergeDocument() 方法

即使是小代碼，也很容易出錯。為了簡化流程，我們MergeDocument()在 StiReport 類中添加了一個用于合并報表的方法。在 JavaScript 報表工具中，此方法稱為mergeDocumentAsync()。

該方法以報表作為輸入，其頁面將添加到當前報表中。它還有一個重載，接受布爾值作為第二個參數，以確定是否需要預先構建報表。這允許在一行中合并兩個 StiReport 對象：report.MergeDocument(report2, true)。

• 使用此合并方法時，會自動處理以下因素：
• 嵌入報告的計量單位被轉換為與主報告的計量單位相匹配；
• 緩存得到正確管理；
• 書簽已復制。

使用儀表板的功能

使用儀表板的模板文件可以同時包含報表頁面和儀表板。但是，儀表板不是靜態對象，沒有固定的尺寸。雖然儀表板有一個Render()方法，但它只是一個占位符，不能像報表那樣構建。儀表板的具體尺寸只能在導出期間設置，因此無法將報表和儀表板組合成單個現成的文檔。該MergeDocument方法僅將另一個模板中的報表頁面添加到主報表中。如果模板僅包含儀表板，則該方法將引發異常。在準備合并模板時應考慮到這一點。
功能

方法的實際應用

首先，確定哪個報告將嵌入到另一個報告非常重要，因為這會影響報告單元和頁面順序。請考慮以下代碼示例：

report1.MergeDocument(report2);

var report = StiReport.CreateNewReport();
report.LoadDocument("documents\\Invoice.mdc");
var report2 = StiReport.CreateNewReport();
report2.LoadDocument("documents\\Christmas.mdc");

report.MergeDocument(report2);

report.Show();

但在某些情況下，您只需在一個地方下載、構建和合并兩個報告模板。合并報告的示例代碼：

var report = StiReport.CreateNewReport();
report.Load("Reports\\Invoice.mrt");
var report2 = StiReport.CreateNewReport();
report2.Load("Reports\\Christmas.mrt");

report.Render();
report2.Render();
report.MergeDocument(report2);

report.Show();

為了簡化代碼，您可以使用MergeDocument()具有兩個參數的方法重載，并將 true 作為第二個參數傳遞。這樣，兩個報告的呈現將在方法中自動處理。例如，使用 build 重載合并報告的代碼如下所示：

var report = StiReport.CreateNewReport();
report.Load("Reports\\Invoice.mrt");
var report2 = StiReport.CreateNewReport();
report2.Load("Reports\\Christmas.mrt");

report.MergeDocument(report2, true);

report.Show();

如果要合并兩份以上的報告，請務必保持一致性，并記住使用主報告的單位。以下是合并三份報告的示例：

var report = StiReport.CreateNewReport();
report.Load("Reports\\Invoice.mrt");
var report2 = StiReport.CreateNewReport();
report2.Load("Reports\\Christmas.mrt");
var report3 = StiReport.CreateNewReport();
report3.Load("Reports\\Report3.mrt");

report.MergeDocument(report2, true);
report.MergeDocument(report3, true);

//report is containing a rendered pages of the report, report2 and report3
report.Show();

JavaScript 報告工具使用一種稱為 的異步合并方法mergeDocumentAsync()。總體而言，上述所有內容都適用于此方法。報告頁面的合并及其呈現都是異步進行的。因此，如果該mergeDocumentAsync()方法使用一個參數，并且需要在合并之前構建報告，renderAsync2()則應在 JavaScript 中對它們調用該方法。例如，合并多個報告：

var report = StiReport.CreateNewReport();
report.Load("Reports\\Invoice.mrt");
var report2 = StiReport.CreateNewReport();
report2.Load("Reports\\Christmas.mrt");

await report.renderAsync2();
await report2.renderAsync2();
await report.mergeDocumentAsync(report2);

viewer.report = report;

使用該mergeDocumentAsync(,)方法將多個模板合并為一份報告。

var report = StiReport.CreateNewReport();
report.Load("Reports\\Invoice.mrt");
var report2 = StiReport.CreateNewReport();
report2.Load("Reports\\Christmas.mrt");

await report.mergeDocumentAsync(report2, true);

viewer.report = report;

這使得在查看、打印或導出之前合并報告變得更加容易。

想要了解Stimulsoft Reports 報價信息的朋友，歡迎咨詢。

加入官方社群 740060302，歡迎相互交流