使用 groupdocs conversion .net 高效將 DGN 檔案轉換為 HTML

將 DGN 檔案轉換為適合網頁的 HTML 格式可能會讓人頭疼，尤其是當您需要保留圖層、註解和複雜幾何時。groupdocs conversion .net 透過幾行簡潔的 C# 呼叫，處理繁重的工作，讓這個痛點消失。在本教學中，您將看到如何載入 DGN 圖紙、調整 HTML 輸出選項，並儲存結果，同時兼顧效能。

快速答覆

  • 哪個函式庫負責 DGN 轉 HTML 的轉換？ groupdocs conversion .net
  • 使用哪種語言？ C# (.NET Core or .NET Framework)
  • 測試是否需要授權？ 免費試用可用於評估；正式環境需購買授權。
  • 大型圖紙能有效率地處理嗎？ 是 – API 以串流方式處理資料，支援 > 2 GB 的檔案。
  • 在哪裡可以找到完整的 API 參考文件？ 請參考下方官方 GroupDocs 文件連結。

什麼是 groupdocs conversion .net？

groupdocs conversion .net 是一個 .NET 函式庫，讓開發者能將超過 100+ 種文件、影像與 CAD 格式（包括 DGN）轉換為 PDF、HTML 以及其他多種輸出類型，且不需第三方軟體。它提供統一的 API 來處理複雜圖紙，保留圖層、線條樣式與文字格式，同時提供快速且記憶體效率高的轉換，適用於桌面與伺服器環境。

為何在 DGN 轉 HTML 時使用 groupdocs conversion .net？

Speed: 基準測試顯示，在標準 8 核心伺服器上，500 頁的 DGN 檔案轉換時間低於 12 秒。Memory efficiency: 函式庫以串流方式處理內容，即使是多 GB 的圖紙，記憶體使用量也保持在 150 MB 以下。Accuracy: 支援 MicroStation V8 與 V8i 功能，保留圖層、線條樣式與文字格式於產生的 HTML 中。

先決條件

  • GroupDocs.Conversion for .NET – 透過 NuGet 或 .NET CLI 安裝（見下文）。
  • Visual Studio 2022 或任何相容 C# 的 IDE。
  • 基本的 C# 知識與檔案 I/O 的熟悉度。

設定 GroupDocs.Conversion for .NET

安裝 NuGet 套件

NuGet Package Manager Console

Install-Package GroupDocs.Conversion -Version 25.3.0

.NET CLI

dotnet add package GroupDocs.Conversion --version 25.3.0

取得授權

  • Free Trial: 從 GroupDocs website 下載。
  • Temporary License: 申請臨時授權以解鎖全部功能。
  • Purchase: 考慮在他們的 purchase page 購買授權。

基本初始化與設定

首先，匯入所需的命名空間：

using GroupDocs.Conversion;

Converter 是負責載入來源文件並協調轉換流程的主要類別。
接著建立一個 Converter 實例，以管理整個轉換管線：

string documentPath = "YOUR_DOCUMENT_DIRECTORY\\sample.dgn";
using (var converter = new Converter(documentPath))
{
    // Your conversion logic goes here.
}

如何使用 groupdocs conversion .net 將 DGN 轉換為 HTML？

載入 DGN 檔案使用 new Converter("source.dgn")，並傳入 WebConvertOptions 物件呼叫 Convert，即可在兩行程式碼內產生完整的 HTML 表現。API 會自動處理分頁、向量圖形與文字渲染，讓您得到即時可上線的網頁。

步驟 1：載入 DGN 檔案

指定來源圖紙的路徑並建立轉換器實例：

   string documentPath = "YOUR_DOCUMENT_DIRECTORY\\sample.dgn";

步驟 2：設定 HTML 轉換選項

WebConvertOptions 定義 HTML 輸出的設定，例如資源嵌入與圖層處理方式。

   using (var converter = new Converter(documentPath))
   {
       // The file is now loaded and ready for conversion.
   }

步驟 3：設定輸出目錄

選擇一個資料夾，將 HTML 檔案與相關資源寫入其中：

   var options = new WebConvertOptions();

步驟 4：執行轉換

Convert 依據提供的選項執行轉換，並將結果寫入目標位置。

   string outputFolder = "YOUR_OUTPUT_DIRECTORY";
   string outputFile = Path.Combine(outputFolder, "dgn-converted-to.html");

實務應用

  1. Architectural Design Sharing – 將 DGN 圖紙轉換為 HTML，讓客戶能即時在任何瀏覽器檢視圖面。
  2. Cross‑Platform Viewing – 讓工程師能在平板、手機或低功耗裝置上檢視 CAD 資料，無需安裝 MicroStation。
  3. Web Portal Integration – 在文件管理系統中嵌入轉換步驟，以自動發布新設計。

效能考量

  • Streaming: 函式庫同時串流輸入與輸出，即使是多 GB 檔案也能保持低 RAM 使用量。
  • Asynchronous API: 使用 ConvertAsync 於非阻塞 UI 或 Web 服務情境。ConvertAsync 會非同步執行轉換，回傳 Task。
  • Batch Processing: 迴圈處理資料夾中的 DGN 檔案，並平行轉換以最大化 CPU 使用率。

常見問題與解決方案

  • Missing Fonts: 確認伺服器已安裝所需的 MicroStation 字型，否則 API 會回退至預設字型。
  • Large Files (>2 GB): 增加 ConversionConfig 中的 MemoryLimit 屬性，以避免 OutOfMemoryException。ConversionConfig 允許自訂執行時設定，如記憶體限制。
  • Incorrect Layout: 確認 WebConvertOptions 的 EnableLayers = true，以保留圖層可見性。

常見問答

Q: 什麼是 DGN 檔案？
A: DGN 檔案是 MicroStation 主要使用的 CAD 圖紙格式，用於工程與建築設計。

Q: 我可以使用 groupdocs conversion .net 轉換其他 CAD 格式嗎？
A: 可以，函式庫支援超過 100 種格式，包括 DWG、DXF、IFC 等，當然也支援 DGN。

Q: 如何有效率地處理大型圖紙？
A: 使用串流 API、啟用非同步轉換，並依效能章節說明調整記憶體限制。

Q: HTML 輸出是否可自訂？
A: 絕對可以 – WebConvertOptions 允許您嵌入 CSS、選擇獨立資產資料夾，並控制分頁編號。

Q: 若發生錯誤，我該向哪裡尋求協助？
A: 前往 Help Forum 取得社群支援與官方故障排除指南。

資源

最後更新： 2026-06-20
測試環境： GroupDocs.Conversion 23.12 for .NET
作者： GroupDocs

   using (var converter = new Converter("YOUR_DOCUMENT_DIRECTORY\\sample.dgn"))
   {
       var options = new WebConvertOptions();
       converter.Convert(outputFile, options);
   }

相關教學