如何使用 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 格式？ 超過 30 種，包括 DGN、DWG、DXF。
  • 最大檔案大小？ 可處理高達 2 GB，且不需將整個檔案載入記憶體。
  • 授權需求？ 生產環境需要有效的 GroupDocs 授權。

什麼是 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+ 上執行，適用於桌面、網頁與雲端情境。

前置條件

  • 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();

相關教學