1. IronPrint
  2. 故障排除
  3. IronPrint 中的 ShowPrintDialog 行为（2024.9 以后）

IronPrint中的ShowPrintDialog行为（2024.9之后）

Curtis Chau
Curtis Chau
已更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

ShowPrintDialog 和 ShowPrintDialogAsync 在不受支持的目标框架上调用时不再抛出异常。 自版本 2024.9 起，它们记录警告并改为回退到 PrintAsync()。

在此更改之前，没有兼容的 TargetFramework 调用任一方法会引发以下错误：

System.AggregateException: 'One or more errors occurred.
(Please try Print/PrintAsync since ShowPrintDialog/ShowPrintDialogAsync in NET Core or NET Standard,
it required UI component so please set more specific OS TargetFrameworks
e.g. net462; net472; net7.0-windows; net7.0-macos; net7.0-maccatalyst; net7.0-android)'

对话框方法需要一个UI组件，而普通的.NET Core或.NET Standard目标中不可用。 早期版本将此视为严重故障并抛出。 该异常在运行时具有破坏性，因此在 2024.9 中故意更改了该行为。

解决方案

回退是自动的，但您可以通过选择正确的目标来控制运行的路径。

1. 依赖自动回退

在不支持的框架下，调用现在会记录警告并路由到 PrintAsync() 而不是抛出。 现有代码继续运行而不会崩溃，但没有出现打印对话框。

警告备用打印在没有对话框的情况下进行。 用户在不支持的目标上看不到打印提示，因此除非您针对UI框架进行操作，否则不要依赖于显示对话框。

2. 选择支持UI的框架以显示对话框

要获取实际的打印对话框，请针对包含UI支持的特定操作系统目标进行构建：

<TargetFrameworks>net462;net472;net7.0-windows;net7.0-macos;net7.0-maccatalyst;net7.0-android</TargetFrameworks>
<TargetFrameworks>net462;net472;net7.0-windows;net7.0-macos;net7.0-maccatalyst;net7.0-android</TargetFrameworks>
XML

在这些框架中的一个到位后，ShowPrintDialog 和 ShowPrintDialogAsync 按预期显示对话框。

Curtis Chau
Curtis Chau
  立即与工程团队聊天
技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

除了开发之外，Curtis 对物联网 (IoT) 有浓厚的兴趣，探索将硬件和软件集成的新方法。在空闲时间，他喜欢玩游戏和构建 Discord 机器人，将他对技术的热爱与创造力相结合。

准备开始了吗？
Nuget 下载 44,051 | 版本: 2026.7 刚刚发布
Still Scrolling Icon

还在滚动吗？

想快速获得证据？ PM > Install-Package IronPrint
运行示例 观看您的文档打到打印机上。