使用 GroupDocs.Conversion for .NET 在 C# 中将 DGN 转换为 Excel (XLSX)

介绍

如果您需要 convert dgn to excel，GroupDocs.Conversion for .NET 提供了一种快速、可靠的解决方案，可在任何 .NET 平台上运行。在本教程中，我们将演示如何安装库、配置转换并运行代码，将 AutoCAD 设计（DGN）文件转换为干净的 XLSX 电子表格。完成后，您将了解为何在企业流水线中首选此方法以及如何将其集成到自己的项目中。

快速答案

  • 哪个库可以将 DGN 转换为 Excel？ GroupDocs.Conversion for .NET。
  • 基本实现需要多长时间？ 大约 10‑15 分钟即可编写并运行。
  • 支持哪些 .NET 版本？ .NET Framework 4.6+、.NET Core 3.1+、.NET 5/6+。
  • 生产环境需要许可证吗？ 是的——付费许可证可移除试用限制。
  • 可以通过 NuGet 安装吗？ 当然——使用 GroupDocs.Conversion 包。

什么是 convert dgn to excel？

Convert dgn to excel 是从 DGN（MicroStation）图纸中提取表格和属性数据并保存为 Excel 工作簿（XLSX）的过程。这使得后续的分析、报告以及与业务系统的集成无需手动数据输入。

为什么使用 GroupDocs.Conversion for .NET 将 DGN 转换为 Excel？

GroupDocs.Conversion for .NET 支持 50+ 输入和输出格式，并且能够在不将整个文档加载到内存中的情况下处理数百页的 DGN 文件，内存使用量可降低最高达 70 %。该库还保留表格、图层和属性数据，在基准测试中实现了 > 98 % 的转换准确率。

先决条件

  • GroupDocs.Conversion for .NET 版本 25.3.0（或更高）。
  • 具备 .NET Core 3.1、.NET 5/6 或 .NET Framework 4.6+ 的开发环境。
  • 基础 C# 知识并可使用 NuGet 包管理器。

所需库及版本

  • GroupDocs.Conversion for .NET 版本 25.3.0。

环境设置要求

    • 具备 .NET 开发环境（最好是 .NET Core 或 .NET Framework）。

知识先决条件

  • 对 C# 编程的基本了解。
  • 熟悉使用 NuGet 包管理器。

具备上述先决条件后，让我们继续安装 GroupDocs.Conversion for .NET。

如何通过 NuGet 安装 GroupDocs Conversion？

安装非常简单：打开 Visual Studio，启动包管理器控制台，运行 Install‑Package 命令。NuGet 系统会解析所有依赖项，将 GroupDocs.Conversion 程序集添加到项目中，并更新项目文件，使您可以立即开始编码。

Install-Package GroupDocs.Conversion

或，使用 .NET CLI，执行：

dotnet add package GroupDocs.Conversion

两条命令都会从 NuGet 仓库获取最新的稳定版本，确保您拥有所有必需的依赖项。

安装

Install-Package GroupDocs.Conversion -Version 25.3.0

.NET CLI

dotnet add package GroupDocs.Conversion --version 25.3.0

获取许可证的步骤

GroupDocs 提供不同的授权选项：

  1. 免费试用 – 测试基本功能。
  2. 临时许可证 – 为更大的项目延长评估时间。
  3. 购买 – 完整的生产使用。请访问官方商店 GroupDocs。

基本初始化和设置

GroupDocs.Conversion 是负责文件转换的核心类。添加包后，您可以使用源文件路径和可选配置实例化一个 Converter 对象。

初始化转换器 Converter 是用于加载文档并执行转换的主要类。

using System;
using GroupDocs.Conversion;

// Initialize the converter with the source DGN file path
var documentPath = "YOUR_DOCUMENT_DIRECTORY\sample.dgn";
using (var converter = new Converter(documentPath))
{
    // Conversion logic will go here
}

完成设置后，让我们实现转换过程。

如何在 C# 中将 DGN 转换为 Excel？

转换工作流包括加载 DGN 文件、配置电子表格选项并调用 Convert 方法。通过将 Converter 类与 SpreadsheetConvertOptions 结合使用，您可以控制工作表名称、包含元数据以及限制页数，从而确保对任何规模的图纸都能生成高效且准确的 Excel 输出。

加载源 DGN 文件

首先，定义输入 DGN 和输出 XLSX 的绝对或相对路径。

步骤 1：定义文件路径

string documentPath = System.IO.Path.Combine("YOUR_DOCUMENT_DIRECTORY", "sample.dgn");
string outputFolder = System.IO.Path.Combine("YOUR_OUTPUT_DIRECTORY", "output");
string outputFile = System.IO.Path.Combine(outputFolder, "dgn-converted-to.xlsx");

// Ensure the output directory exists
if (!System.IO.Directory.Exists(outputFolder))
{
    System.IO.Directory.CreateDirectory(outputFolder);
}

步骤 2：加载 DGN 文件

using (var converter = new Converter(documentPath))
{
    // Conversion process will be defined here
}

设置转换选项

ConversionException 在转换过程遇到错误时抛出。SpreadsheetConvertOptions 定义了 Excel 输出的设置，例如工作表命名、元数据包含和页范围。

// Specify that we're converting to an Excel spreadsheet format
var options = new SpreadsheetConvertOptions();

执行转换

最后，执行转换并将结果写入磁盘。

步骤 4：执行并保存转换

converter.Convert(outputFile, options);

故障排除提示

  • 权限 – 确认进程对文件夹具有读/写访问权限。
  • 错误处理 – 将转换调用包装在 try‑catch 块中，以捕获 ConversionException 并记录详细信息。

常见问题及解决方案

问题解决方案
“未找到文件”错误使用 Path.GetFullPath 解析相对路径并确保文件存在。
大型 DGN 文件的内存激增通过设置 ConverterOptions.PageRange 将文件分块处理，以限制每次转换的页数。
Excel 中缺少数据启用 SpreadsheetConvertOptions.IncludeMetadata = true 以保留属性表。

实际应用

将 DGN 文件转换为 Excel 在以下方面非常有价值：

  1. 项目管理 – 将材料清单和进度数据导出到电子表格进行跟踪。
  2. 数据分析 – 利用 Excel 的数据透视表和图表对 CAD 派生数据进行分析。
  3. ERP 集成 – 自动将设计规格流入企业资源规划系统。

性能考虑因素

为了保持转换快速且内存高效：

  • 在批处理运行期间关闭未使用的应用程序。
  • 使用 using 语句及时释放对象。
  • 在可能的情况下复用单个 Converter 实例 以处理多个文件。

结论

现在，您已经拥有使用 GroupDocs.Conversion for .NET 将 DGN 转换为 Excel (XLSX) 的完整、可投产的方案。此方法可减少手动数据输入、加快报告生成，并与基于 .NET 的后端服务无缝集成。探索其他格式——PDF、DOCX、PPTX——并扩展您的自动化流水线。

常见问题

问：我可以转换除 DGN 之外的其他 CAD 格式吗？
答：是的，GroupDocs.Conversion 还支持 DWG、DXF 和 DWF 文件，允许您输出相同的 XLSX。

问：试用版对文件大小有限制吗？
答：免费试用版将转换限制在 5 MB 以下的文件；临时或付费许可证可取消此限制。

问：如何处理受密码保护的 DGN 文件？
答：通过在 Converter 构造函数中使用 ConverterSettings.Password 传递密码。

问：该库能在 Linux 容器中运行吗？
答：当然——GroupDocs.Conversion 是跨平台的，可在基于 .NET Core 的 Docker 镜像中运行。

问：在哪里可以找到详细的 API 文档？
答：请访问官方文档 Documentation。

最后更新: 2026-06-30
测试环境: GroupDocs.Conversion 25.3.0 for .NET
作者: GroupDocs

资源

祝编码愉快，尽情探索 GroupDocs.Conversion for .NET 的全部潜力！

相关教程