XYS.FRCore 4.2.0

XYS.FRCore

FastReport.Core 渲染宿主。只负责：拿 XYS.FR（XYS.FR.V3 项目）准备好的 DataSet 与模板路径，调用 FastReport.Core 引擎导出 PDF/JPG/HTML/XLSX 流。不含数据契约与配置解析（实体注册、FRTables.frd 生成、模板号映射都在 XYS.FR 里），也不含打印（见下）。

• 目标框架：net462 / netstandard2.0 / netcoreapp3.1 / net8.0
• 报表引擎：FastReport.Core，版本按目标框架分流（见下）
• 依赖：XYS.FR.V3（传递带入 XYS.Utils.Sys、XYS.Utils.Log4Net）
• 程序集名：XYS.FRCore；命名空间 XYS.FR

⚠️ 当前引用的是 Demo 版 FastReport 包，导出结果带演示水印、有页数限制。正式部署需替换为已授权的 FastReport.Core 包（仅需改 PackageReference，代码无需改动）。

与 XYS.FRNet 的分工

两者的服务基类 API 形状刻意保持一致（ExportStream + ConfigureExport + ExportType 分发），便于在两个引擎间迁移。

不提供打印

BaseFRCoreService 不实现 IFRPrintService，本项目里根本没有 Print 方法。

原因：FastReport.Core 是跨平台版，不含任何打印 API —— 已核实 2023.3.13 版中 Report.Print()、Report.PrintPrepared()、PrintSettings 类型全部不存在（这些依赖 System.Drawing.Printing / WinForms）。

打印须由宿主完成：先用 ExportStream 导出 PDF，再交给宿主的打印组件。本解决方案中由 XYS.FRCore.PrintWinService 经 PrintIt.Core（Pdfium）打印。若需要 FastReport 直接打印，请改用 XYS.FRNet。

4.0.0 时 Print 是 IFRService / BaseFRService 的抽象成员，本项目只能"实现了但恒抛 NotSupportedException"，属 Liskov 违例。XYS.FR 4.1.0 把 IFRService 拆成 IFRExportService + IFRPrintService 后，本项目直接不声明打印接口，该违例已消除。

核心类型

BaseFRCoreService 是本项目唯一的公开类型。

快速使用

using System;
using System.Collections.Generic;
using System.IO;
using XYS.FR;

public sealed class LabExportService : BaseFRCoreService
{
    public LabExportService()
    {
        LoggerName = "LabExportService";
        ActualType = typeof(LabExportService);
        Init();                              // 注册实体 + 生成 frd + 加载配置，放在构造函数末尾
    }

    protected override List<Type> GetFRTypes() => new List<Type>
    {
        typeof(FRInfo),
        typeof(FRItem),
    };

    protected override void InitFRConfig()
    {
        var cfg = new XmlConfigManager();    // 默认 AppBase/Config/fr.config.xml
        cfg.Init();                          // 失败抛异常，视为致命错误
        ConfigManager = cfg;
    }
}

var svc = new LabExportService();
var report = new FRReport { ModelNo = "LAB001", RID = "R123" };
report.Items.Add(new FRInfo { ID = "1", RID = "R123", PatName = "张三" });

using (var fs = File.Create("out.pdf"))
{
    svc.ExportStream(report, fs, ExportType.Pdf);
}

导出格式映射

默认设置只保证单流输出这一底线语义：图片/HTML 导出若不关掉分文件，FastReport 只会把首页写进 Stream，其余页和图片会散落成流外的独立文件。

重写 ConfigureExport 可定制签名、分辨率、压缩等，建议先调 base。

关键契约

ExportStream 无状态：每次调用独立取空数据集副本、独立 new Report()，同一实例可并发调用。

FastReport.Core 版本分流

FastReport.Core 2025.2.8-demo 只提供 net462 / net6.0 / net6.0-windows7.0，没有 netcoreapp3.1 与 netstandard2.0 的 lib，因此不能统一到单一版本：

csproj 中另显式钉住了 FastReport.Compat 2025.2.8 与 FastReport.DataVisualization 2025.2.8。原因：FastReport.Core 2025.2.8-demo 的 nuspec 声明依赖这两个包的 2025.2.8-demo 版本，但它们不存在 -demo 后缀的版本，NuGet 只能回退推断到稳定版并对每个 TFM 报 NU1603。显式钉版后告警消失，而实际解析结果不变。

改动本项目的 TargetFrameworks 时，务必同步检查所选 FastReport.Core 版本是否提供对应的 lib。

4.2.0 变更（相对 4.1.0）

• 新增目标框架 net8.0
• net462 与 net8.0 的 FastReport.Core 升到 2025.2.8-demo；netcoreapp3.1 与 netstandard2.0 保持 2023.3.13-demo（该版本无这两个 TFM 的 lib）
• 四个按 TFM 拆分的条件 ItemGroup 合并为两个
• 显式钉住 FastReport.Compat / FastReport.DataVisualization 稳定版，消除 16 条 NU1603

4.1.0 变更（相对 4.0.0）

破坏性

• 跟随 XYS.FR 4.1.0 的接口拆分，BaseFRCoreService.Print(...) 整块删除。该方法在 4.0.0 中恒抛 NotSupportedException，从无可用调用方。
• 本类现在只实现 IFRExportService（经 BaseFRService），不声明 IFRPrintService。

4.0.0 变更（相对 3.0.1）

破坏性

• BaseStreamService 更名为 BaseFRCoreService，与 XYS.FRNet 的 BaseFRNetService 对称
• 泛型导出方法 ExportStream<T> 删除，改为按 ExportType 枚举分发的 ExportStream(FRReport, Stream, ExportType)
• protected abstract void SetExport(ExportBase) → protected virtual void ConfigureExport(ExportBase, ExportType)，由 abstract 改 virtual
• 依赖由 FastReport.Core 2021.4.16-demo 升到 2023.3.13-demo；目标框架 netstandard2.1 换为 netcoreapp3.1（与该包实际提供的 TFM 一致）
• 由 NuGet XYS.FR 改为 ProjectReference ..\XYS.FR.V3，与解决方案统一

修复

• 项目此前无法编译：ExportType.pdf 大小写未跟随 XYS.FR 4.0.0 的 PascalCase 改名（CS0117）；ExportStream 缺 override 隐藏基类抽象成员（CS0533）；方法体残留已删除的泛型参数 new T()
• throw ex; 丢失堆栈：改为 throw;
• Config.WebMode 每次导出都重设：它是进程级全局配置，移入静态构造函数只设一次
• catch 块内可能二次抛 NRE：日志用 ActualType.FullName，子类未设 ActualType 时会 NRE 并掩盖真实异常，现回退到运行时类型名
• 图片/HTML 导出丢页：单 Stream 输出下未关 SeparateFiles / 未开 EmbedPictures，只有首页进流

清理

• MethodBase.GetCurrentMethod().Name 反射取名 → nameof
• README 从残桩重写（原文写"FastReport Core 2021 版本集成"，实际引用 2023.3.13）

注意事项

• 多目标下语言版本不一致：net462 / netstandard2.0 默认 C# 7.3，netcoreapp3.1 默认 C# 8。本项目代码按 C# 7.3 编写，刻意避开 switch 表达式等 C# 8+ 语法。
• 完整版 FastReport .NET 的 ReportSettings.ShowProgress / ShowPerformance 是 WinForms 专属属性，Core 版的 ReportSettings 不含它们（Core 无进度 UI，本就无需关闭）。
• Init() 放在子类构造函数末尾。
• 同进程内允许多个子类共存，共享 XYS.FR 的 DataStruct 实体注册表。