如何使用 GroupDocs.Conversion for .NET 将 DGN 转换为 PDF
将 DGN 图纸转换为 PDF 是在需要与没有专业软件的利益相关者共享 CAD 文件时的常见步骤。在本教程中，您将学习如何使用 GroupDocs.Conversion for .NET 快速且可靠地 将 dgn 转换为 pdf。我们将逐步介绍安装、授权以及完整的代码示例，并展示如何针对大型工程图纸优化性能。
快速答案
- 哪个库负责转换？ GroupDocs.Conversion for .NET.
- 主要方法调用？
converter.Convert(sourcePath, new PdfConvertOptions()). - 支持的 CAD 格式？ Over 30, including DGN, DWG, DXF.
- 最大文件大小？ Up to 2 GB can be processed without loading the whole file into memory.
- 许可证要求？ A valid GroupDocs license is needed for production use.
什么是 convert dgn to pdf？
convert dgn to pdf 是将 MicroStation DGN 文件转换为便携式文档格式（PDF）的过程，能够保留矢量图形、图层、线宽和注释。此转换实现了精确的渲染、打印以及在任何平台上的轻松分发，使没有 CAD 软件的用户也能准确查看图纸。
为什么使用 GroupDocs.Conversion for .NET？
GroupDocs.Conversion 支持 30+ 输入和输出格式，并且能够处理高达 2 GB 的文件，同时由于其流式架构，内存使用保持在 100 MB 以下。该库可运行于 .NET Framework 4.6+、.NET Core 3.1+ 和 .NET 6+，适用于桌面、Web 和云场景。
前置条件
- GroupDocs.Conversion for .NET（版本 25.3.0 或更高）
- 开发环境，例如 Visual Studio 2022 或 Visual Studio Code
- 在机器上安装 .NET 6 SDK
- 有效的 GroupDocs 许可证文件（试用版或商业版）
必需的库、版本和依赖项
- GroupDocs.Conversion for .NET – 25.3.0
- Newtonsoft.Json – 用于内部配置处理（作为依赖项自动安装）
环境设置要求
确保 .NET 运行时与项目的目标框架匹配。GroupDocs.Conversion 可在 Windows、Linux 和 macOS 上运行。
如何在 C# 中将 DGN 转换为 PDF？
Converter 类是加载文档并执行格式转换的核心组件。PdfConvertOptions 指定 PDF 输出的设置，如页面大小和字体嵌入。加载源 DGN 文件，配置转换选项，然后调用 Convert 方法——整个操作可以在三行代码中完成。这种直接方式确保图层、线宽和文本注释在生成的 PDF 中忠实再现。
// Define paths
string outputFolder = Path.Combine(@"YOUR_OUTPUT_DIRECTORY");
string documentPath = Path.Combine(@"YOUR_DOCUMENT_DIRECTORY\sample.dgn");
// Initialize the converter and perform conversion
var converter = new GroupDocs.Conversion.Converter(documentPath);
converter.Convert(outputFolder, new GroupDocs.Conversion.Options.PdfConvertOptions());
上面的代码片段演示了 核心工作流：实例化 Converter 类，指定输出位置，并传入 PdfConvertOptions 对象。库会自动检测 DGN 格式并应用相应的渲染引擎。
步骤详解
步骤 1：安装 NuGet 包
在 Visual Studio 中打开 Package Manager Console 并运行：
Install-Package GroupDocs.Conversion -Version 25.3.0
或者如果您更喜欢命令行安装，可使用 .NET CLI：
dotnet add package GroupDocs.Conversion --version 25.3.0
这两个命令都会将最新的稳定版 GroupDocs.Conversion 包添加到您的项目中。
步骤 2：添加许可证
将 GroupDocs.Conversion.lic 文件放置在项目根目录，并在应用程序启动时进行注册：
GroupDocs.Conversion.License license = new GroupDocs.Conversion.License();
license.SetLicense("GroupDocs.Conversion.lic");
专业提示： 将许可证文件置于源代码控制之外，并在生产环境中从安全位置加载它。
步骤 3：执行转换
使用前面展示的代码块。调整 outputFolder 和 documentPath 以指向实际目录。PdfConvertOptions 类允许您控制页面大小、方向以及是否嵌入字体。
步骤 4：验证结果
转换完成后，在任意查看器中打开生成的 PDF，以确认所有图纸元素均正确显示。对于批量处理，可在遍历 DGN 文件集合的 foreach 循环中包装转换调用。
常见问题及解决方案
- 缺少字体 – 确保在主机上安装所需的 CAD 字体，或通过
PdfConvertOptions.EmbedFonts = true嵌入它们。 - 大文件导致超时 – 如果在 Web API 中运行转换，请增加 HTTP 请求超时时间，或在转换前将图纸拆分为更小的图纸。
- 未找到许可证 – 核实
GroupDocs.Conversion.lic的路径，并确认运行进程对该文件具有读取权限。
常见问答
Q: 我可以转换受密码保护的 DGN 文件吗？
A: 是的。通过接受 LoadOptions 对象的 Converter 构造函数重载提供密码。LoadOptions 允许在加载文档时提供诸如密码等附加参数。
Q: 该库能在 Linux 容器中运行吗？
A: 当然可以。GroupDocs.Conversion for .NET 完全跨平台，可在基于 Alpine 或 Ubuntu 的 Docker 容器中运行。
Q: 支持哪些 .NET 版本？
A: 官方支持 .NET Framework 4.6+、.NET Core 3.1+、.NET 5 和 .NET 6。
Q: 如何处理成千上万图纸的批量转换？
A: 使用 Task.WhenAll 进行异步处理（Task.WhenAll 会等待多个异步操作完成），并限制并发以避免耗尽 CPU 或内存。
Q: 是否可以仅转换特定的布局或图纸？
A: 可以。将 PdfConvertOptions.Layouts 设置为包含所需布局标识的集合。
结论
现在，您已经拥有使用 GroupDocs.Conversion for .NET 将 convert dgn to pdf 的完整、可投入生产的指南。按照上述步骤，您可以轻松将 CAD 转 PDF 转换集成到桌面工具、Web 服务或自动化流水线中。探索诸如水印、加密和自定义页面尺寸等附加选项，以使输出符合贵组织的标准。
最后更新： 2026-06-15
测试环境： GroupDocs.Conversion 25.3.0 for .NET
作者： GroupDocs
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
// Initialize converter object
groupdocsConversion = new Converter("path/to/your/file.dgn");
// Convert to PDF settings
PdfConvertOptions options = new PdfConvertOptions();
