將 DGN 轉換為 Excel (XLSX)(C#)使用 GroupDocs.Conversion for .NET
介紹
If you need to convert dgn to excel, GroupDocs.Conversion for .NET offers a fast, reliable solution that works on any .NET platform. In this tutorial we’ll walk through installing the library, configuring the conversion, and running the code that transforms an AutoCAD Design (DGN) file into a clean XLSX spreadsheet. By the end you’ll understand why this approach is preferred in enterprise pipelines and how to integrate it into your own projects.
快速解答
- 哪個函式庫可以將 DGN 轉換為 Excel? GroupDocs.Conversion for .NET.
- 基本實作需要多長時間? Around 10‑15 minutes to write and run.
- 支援哪些 .NET 版本? .NET Framework 4.6+, .NET Core 3.1+, .NET 5/6+.
- 生產環境需要授權嗎? Yes – a paid license removes trial limits.
- 可以透過 NuGet 安裝嗎? Absolutely – use the
GroupDocs.Conversionpackage.
什麼是將 DGN 轉換為 Excel?
Convert dgn to excel 是從 DGN(MicroStation)圖紙中提取表格與屬性資料,並儲存為 Excel 工作簿(XLSX)的過程。此舉可讓後續分析、報告以及與業務系統的整合,免除手動資料輸入。
為何使用 GroupDocs.Conversion for .NET 來將 DGN 轉換為 Excel?
GroupDocs.Conversion for .NET 支援 50 多種輸入與輸出格式,且能在不將整個文件載入記憶體的情況下處理多百頁的 DGN 檔案,將 RAM 使用量降低至最高 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?
Installation is straightforward: open Visual Studio, launch the Package Manager Console, and run the Install‑Package command. The NuGet system resolves all dependencies, adds the GroupDocs.Conversion assembly to your project, and updates the project file so you can start coding immediately.
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 提供多種授權選項:
- 免費試用 – 測試基本功能。
- 臨時授權 – 為較大型專案延長評估時間。
- 購買 – 完整的生產使用。請至官方商店查看 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?
The conversion workflow consists of loading the DGN file, configuring spreadsheet options, and invoking the Convert method. By using the Converter class together with SpreadsheetConvertOptions, you can control sheet names, include metadata, and limit pages, ensuring efficient and accurate Excel output for any size drawing.
載入來源 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 在以下情境中非常有價值:
- 專案管理 – 將材料清單與排程資料匯出至試算表以進行追蹤。
- 資料分析 – 利用 Excel 的樞紐分析表與圖表分析 CAD 衍生的資料。
- ERP 整合 – 自動將設計規格流入企業資源規劃系統。
效能考量
為了保持轉換速度快且記憶體效率高:
- 關閉未使用的應用程式 於批次執行期間。
- 立即釋放物件,使用
using陳述式。 - 盡可能重複使用單一
Converter實例 以處理多個檔案。
結論
您現在已掌握使用 GroupDocs.Conversion for .NET 將 DGN 轉換為 Excel (XLSX) 的完整、可投入生產的範例。此方法可減少手動資料輸入、加速報表產出,且能無縫整合於基於 .NET 的後端服務。請探索其他格式—PDF、DOCX、PPTX,並擴充您的自動化流程。
常見問答
Q: 我可以轉換除 DGN 之外的其他 CAD 格式嗎?
A: 是的,GroupDocs.Conversion 亦支援 DWG、DXF 與 DWF 檔案,讓您可輸出相同的 XLSX。
Q: 試用版有檔案大小限制嗎?
A: 免費試用版將轉換檔案限制在 5 MB 以下;臨時授權或付費授權則取消此上限。
Q: 如何處理受密碼保護的 DGN 檔案?
A: 在 Converter 建構子中透過 ConverterSettings.Password 傳入密碼。
Q: 此函式庫能在 Linux 容器上運作嗎?
A: 當然可以 — GroupDocs.Conversion 為跨平台,能在基於 .NET Core 的 Docker 映像上執行。
Q: 哪裡可以找到詳細的 API 文件?
A: 請前往官方文件 Documentation。
最後更新: 2026-06-30
測試環境: GroupDocs.Conversion 25.3.0 for .NET
作者: GroupDocs
資源
祝開發愉快,並探索 GroupDocs.Conversion for .NET 的全部潛力!