報(bào)表控件stimulsoft教程：在報(bào)表、儀表板和 PDF 表單自動(dòng)生成縮略圖

翻譯|使用教程|編輯：吉煒煒|2025-06-27 10:25:11.507|閱讀 134 次

概述：Stimulsoft中的縮略圖提供了一種簡(jiǎn)單有效的方法來直觀地呈現(xiàn)報(bào)表、儀表板和表單。它們可以自動(dòng)或手動(dòng)生成，甚至可以用自定義圖像替換。借助 StiThumbnailHelper類，開發(fā)人員可以使用靈活的工具來管理任何集成場(chǎng)景中的縮略圖。

# 界面/圖表報(bào)表/文檔/IDE等千款熱門軟控件火熱銷售中 >>

相關(guān)鏈接：

了解縮略圖的工作原理在使用Stimulsoft Demo、Stimulsoft Server和Stimulsoft Cloud時(shí)非常有用。例如，您可以在此處查看縮略圖的實(shí)際效果 - 當(dāng)側(cè)邊欄折疊時(shí)，將顯示縮略圖而不是資源列表。在本文中，我們將探討 Stimulsoft 產(chǎn)品中報(bào)表、儀表板和 PDF 表單的縮略圖（也稱為預(yù)覽）的作用。例如，縮略圖顯示在報(bào)表查看器中，允許用戶快速直觀地識(shí)別資源內(nèi)容。

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

Stimulsoft Ultimate 最新版下載

Stimulsoft 產(chǎn)品支持自動(dòng)生成縮略圖，也可以使用專用的StiThumbnailHelper類手動(dòng)控制生成過程。此外，您還可以使用自定義圖像代替自動(dòng)生成的縮略圖。

自動(dòng)生成縮略圖

將報(bào)告添加到以下位置時(shí)會(huì)自動(dòng)生成縮略圖：

Stimulsoft Server和 – 首次添加到工作區(qū)。

– 首次添加到資源列表。

用戶無需執(zhí)行任何其他操作。在這種情況下，會(huì)生成并保存一個(gè)縮略圖，并一直使用到縮略圖被刪除（或報(bào)表本身被刪除）。主要限制在于，縮略圖在報(bào)表修改時(shí)不會(huì)更新。要更新縮略圖，必須手動(dòng)刪除并重新生成舊的縮略圖文件。

使用 StiThumbnailHelper 管理縮略圖

將 Stimulsoft 集成到自定義項(xiàng)目或應(yīng)用程序中時(shí)，您可以使用StiThumbnailHelper類來控制縮略圖生成過程。

GetThumbnailPath(string path)生成給定報(bào)告的.thumb縮略圖文件的路徑，同時(shí)考慮到操作系統(tǒng)的顯示縮放比例。

SaveThumbnail(StiReport report, string path)將圖像字節(jié)數(shù)組（即第一個(gè)渲染報(bào)表頁面的縮略圖）返回到.thumb文件。此方法僅適用于已渲染的報(bào)表，或者您可以調(diào)用report.Render()。

GetThumbnail(string path)從.thumb文件中返回指定報(bào)表縮略圖的字節(jié)數(shù)組。如果該文件不存在，則返回 null。

GetThumbnailFromTemplateAsync(string path)從.mrt模板文件中異步檢索報(bào)告縮略圖。

GetThumbnailFromTemplate(string path, bool skipImage = false)同步創(chuàng)建一個(gè)StiThumbnailReport對(duì)象，該對(duì)象包含路徑、報(bào)表名稱、儀表板標(biāo)志（“IsDbs”）和圖像。如果之前保存過縮略圖，則加載該縮略圖。如果沒有保存，則加載報(bào)表、生成圖像并保存.thumb文件。此方法還會(huì)檢測(cè)數(shù)據(jù)源是儀表板還是常規(guī)報(bào)表。

這樣，可以根據(jù)需要隨時(shí)生成報(bào)告的縮略圖。

使用報(bào)告圖像屬性

每個(gè)報(bào)表、儀表板或 PDF 表單模板都可以在“報(bào)表圖像”屬性中包含自己的圖像。該圖像將用作縮略圖，而不是自動(dòng)生成的預(yù)覽圖。這適用于 Stimulsoft Demo、Stimulsoft Server 和 Stimulsoft Cloud 等產(chǎn)品。例如，您可以設(shè)置一個(gè)靜態(tài)圖像，無論實(shí)際報(bào)表內(nèi)容如何，該圖像都會(huì)顯示在界面中。注意：

圖像存儲(chǔ)在報(bào)告文件中。如果添加或引用較大的圖像文件，則會(huì)增加報(bào)告文件的整體大小。前面我們提到，自動(dòng)生成的縮略圖只能通過刪除現(xiàn)有的預(yù)覽文件來更新。但是，當(dāng)將 Stimulsoft 集成到您自己的應(yīng)用程序中時(shí)，您可以動(dòng)態(tài)生成新的縮略圖并將其直接分配給ReportImage屬性。


...
//Load report
var report = new StiReport;
var templatePath = "Reports\\MyReport.mrt";
report.Load(templatePath);

// Generate a new thumbnail from the report template
var thumbnail = await Stimulsoft.Wizard.Wpf.Info.Helper.StiThumbnailHelper.GetThumbnailFromTemplateAsync(templatePath);

// Convert byte array to System.Drawing.Image
using (var ms = new MemoryStream(thumbnail.Image))
{
// Assign generated thumbnail to the ReportImage property
report.ReportImage = System.Drawing.Image.FromStream(ms);
}

// Call report in designer where ReportImage will be used as the report thumbnail
report.Design();
...

實(shí)際上，這意味著可以在運(yùn)行時(shí)為報(bào)表生成新的縮略圖，并將其保存到“報(bào)表圖像”屬性中。這樣，您就可以在不刪除現(xiàn)有報(bào)表或其預(yù)覽文件的情況下更新縮略圖。

重點(diǎn)——?jiǎng)赢?/span>

生成縮略圖時(shí)需要考慮一個(gè)重要方面——?jiǎng)赢嫞绕涫窃趦x表板中。對(duì)于報(bào)表，縮略圖是從第一個(gè)渲染頁面生成的，該頁面用作預(yù)覽圖像。然而，儀表板沒有明確的渲染狀態(tài)，它們是實(shí)時(shí)運(yùn)行的。這意味著，如果在縮略圖生成時(shí)，儀表板元素的動(dòng)畫尚未完全完成，預(yù)覽可能無法準(zhǔn)確反映實(shí)際內(nèi)容。例如，圖表可能僅顯示部分渲染。為了確?？s略圖完全符合預(yù)期外觀，必須考慮動(dòng)畫的持續(xù)時(shí)間。Stimulsoft中的縮略圖提供了一種簡(jiǎn)單有效的方法來直觀地呈現(xiàn)報(bào)表、儀表板和表單。它們可以自動(dòng)或手動(dòng)生成，甚至可以用自定義圖像替換。借助 StiThumbnailHelper類，開發(fā)人員可以使用靈活的工具來管理任何集成場(chǎng)景中的縮略圖。正確使用此功能可以改進(jìn)導(dǎo)航，增強(qiáng)用戶界面，并豐富在應(yīng)用程序中與報(bào)表交互的整體體驗(yàn)。

---------------------------------------------------------------------------

關(guān)于慧都科技：

慧都科技是一家行業(yè)數(shù)字化解決方案公司，長期專注于軟件、油氣與制造行業(yè)。公司基于深入的業(yè)務(wù)理解與管理洞察，以系統(tǒng)化的業(yè)務(wù)建模驅(qū)動(dòng)技術(shù)落地，幫助企業(yè)實(shí)現(xiàn)智能化運(yùn)營與長期競(jìng)爭(zhēng)優(yōu)勢(shì)。在軟件工程領(lǐng)域，我們提供開發(fā)控件、研發(fā)管理、代碼開發(fā)、部署運(yùn)維等軟件開發(fā)全鏈路所需的產(chǎn)品，提供正版授權(quán)采購、技術(shù)選型、個(gè)性化維保等服務(wù)，幫助客戶實(shí)現(xiàn)技術(shù)合規(guī)、降本增效與風(fēng)險(xiǎn)可控?；鄱伎萍际荢timulsoft的在中國區(qū)的合作伙伴，Stimulsoft作為圖表報(bào)表領(lǐng)域的優(yōu)秀產(chǎn)品，幫助企業(yè)實(shí)現(xiàn)輕松構(gòu)建高性能的表格報(bào)告及圖表。

下載|體驗(yàn)更多Stimulsoft產(chǎn)品，請(qǐng)咨詢，或撥打產(chǎn)品熱線：023-68661681