首页 > 动态 > 报表控件stimulsoft操作：将 Stimulsoft 工具集成到 .NET MAUI

报表控件stimulsoft操作：将 Stimulsoft 工具集成到 .NET MAUI

发布时间 : 2025-02-24 13:52:11.300|阅读 19 次

概述：本文探讨了将 Stimulsoft 产品集成到.NET MAUI项目中。.NET多平台应用程序 UI框架（称为.NET MAUI）支持为 Windows、macOS、iOS 和 Android 等操作系统开发跨平台应用程序。虽然 Stimulsoft 没有为MAUI提供特定的报告组件，但您可以使用Reports.BLAZOR产品集成报告系统，对于分析系统，可以使用Dashboards.BLAZOR

步骤 1

首先，创建一个新的.NET MAUI Blazor 混合应用项目。对于目标框架，建议选择 .NET 8，因为它被指定为具有延长生命周期和支持的 LTS（长期支持）框架。我们的产品还支持 .NET 9。

步骤 2

创建演示.NET MAUI项目后，我们将集成 Stimulsoft 的报告功能。首先，安装报告系统所需的 NuGet 包 — Stimulsoft.Reports.Blazor。如果还需要分析功能，请同时包括Stimulsoft.Dashboards.Blazor包。

步骤 3

报告的导出命令将位于项目中的单独页面上。我们将在第 5 步中添加此页面，但现在，让我们通过添加链接来修改导航菜单。为此，请在Components / Layout / NavMenu.razor文件中插入以下代码块：
NavMenu.razor



...
<div class="nav-item px-3">
	<NavLink class="nav-link" href="/export">
		<span class="bi bi-list-nested-nav-menu" aria-hidden="true"></span>Export Report
	</NavLink>
</div>
...

您需要将报告文件添加到项目中。这些文件可以包括报告或仪表板模板（*.mrt、*.mrz、*.mrx），以及构建的报告文件（*.mdc、*.mdz、*.mdx）。例如，将SimpleList.mrt报告模板添加到Resources / raw文件夹。

步骤 5

接下来，您应该添加一个用于导出报告的页面。在Components / Pages文件夹中创建一个名为Export.razor的新文件。在此示例中，将添加三个按钮：

导出 PDF按钮。触发将报告导出为 PDF 文件并使用在操作系统中注册的 PDF 查看器打开它。

导出 HTML按钮。触发将报告导出到 HTML 文件并直接在应用程序中显示报告页面。

共享 PDF按钮。触发将报告导出为 PDF 文件并打开操作系统中可用的“共享”菜单。

导航菜单

@page "/export"

@using Stimulsoft.Report;
@using Stimulsoft.Report.Blazor;
@using Stimulsoft.Report.Web;
@using Stimulsoft.Report.Export;
@using System.Text;

<button @onclick="@ExportPdf">Export PDF</button>
<button @onclick="@ExportHtml">Export HTML</button>
<button @onclick="@SharePdf">Share PDF</button>

<br /><br />
<div>@((MarkupString)HtmlContent)</div>

@code {
	private StiReport Report = new StiReport();
	private string HtmlContent = string.Empty;

	protected override async Task OnInitializedAsync()
	{
		var reportStream = await FileSystem.OpenAppPackageFileAsync("SimpleList.mrt");
		Report.Load(reportStream);
	}

	private void ShowHtmlReport()
	{
		var service = new StiHtmlExportService();
		service.RenderAsDocument = false;

		var settings = new StiHtmlExportSettings();

		using (var stream = new MemoryStream())
		{
			service.ExportHtml(Report, stream, settings);

			var buffer = stream.ToArray();
			HtmlContent = Encoding.UTF8.GetString(buffer);
		}
	}

	private async Task ExportDocument(StiExportFormat format, string fileName, bool shareFile = false)
	{
		if (Report == null) return;

		await Task.Run(() => Report.Render());

		if (format == StiExportFormat.Html)
		{
			ShowHtmlReport();
		}
		else
		{
			var filePath = Path.Combine(FileSystem.Current.CacheDirectory, fileName);
			using (var fileStream = new FileStream(filePath, FileMode.Create, FileAccess.Write))
			{
				Report.ExportDocument(StiExportFormat.Pdf, fileStream);
			}

			if (shareFile)
			{
				var file = new ShareFile(filePath);
				await Share.Default.RequestAsync(new ShareFileRequest(fileName, file));
			}
			else
			{
				var file = new ReadOnlyFile(filePath);
				await Launcher.OpenAsync(new OpenFileRequest(filePath, file));
			}
		}
	}

	private Task ExportPdf() => ExportDocument(StiExportFormat.Pdf, "Simple List.pdf");
	private Task ExportHtml() => ExportDocument(StiExportFormat.Html, "Simple List.html");
	private Task SharePdf() => ExportDocument(StiExportFormat.Pdf, "Simple List.pdf", true);
}

步骤 6

至此，Stimulsoft 的集成已完成。报告系统现已嵌入到.NET MAUI项目中，最后一步是启动项目。演示项目的导航菜单中将出现一个新的导出报告链接。单击此链接将打开一个页面，其中包含各种与报告相关的操作，例如导出为 PDF 并将报告显示为 HTML 文本。您还可以将报告导出为 PDF 文件并共享。如果需要，可以轻松修改此代码以启用导出为其他格式，例如图像或富文本。此外，导出选项允许您配置导出特定报告页面或调整其他参数。您可以在 .NET MAUI 项目中下载集成 Stimulsoft Reports.BLAZOR 报告工具的示例。因此，在使用.NET Multi-platform App UI开发应用程序时，您可以集成报告和数据分析系统，而无需报告查看器或设计器。