如何使用 GroupDocs.Conversion for .NET 將 DGN 轉換為 PNG：完整指南
將 DGN 檔案轉換為 PNG 圖片是工程師、建築師以及任何需要以輕量、適合網路的圖片分享 CAD 圖紙的常見任務。在本教學中，您將學習如何使用 GroupDocs.Conversion for .NET 快速且可靠地 convert dgn to png。我們將逐步說明安裝、載入 DGN 檔案、設定 PNG 選項以及儲存結果，同時解釋每個步驟對效能與準確性的影響。
快速答案
- 哪個函式庫負責轉換？ GroupDocs.Conversion for .NET.
- 我可以一次呼叫轉換多頁 DGN 嗎？ 可以 – API 會自動處理每一頁。
- 基本使用是否需要授權？ 開發階段可使用試用版；正式環境需購買完整授權。
- 支援哪些 .NET 版本？ .NET Framework 4.5+、.NET Core 3.1+、.NET 5/6/7.
- 轉換是否具備記憶體效能？ 具備，會串流頁面且不會將整個檔案載入 RAM。
GroupDocs.Conversion for .NET 是什麼？
GroupDocs.Conversion for .NET 是一套功能強大的 SDK，能在超過 100 種檔案格式之間進行程式化轉換，包含 CAD 圖紙、PDF、影像與辦公文件。它可處理高達 500 MB 的檔案而不需將整個文件載入記憶體，十分適合伺服器端批次作業。
為何在 CAD 圖紙上使用 GroupDocs.Conversion？
GroupDocs.Conversion 提供速度、準確度與可擴展性的結合，使其成為處理 CAD 圖紙的理想選擇。它能快速轉換複雜的 DGN 檔，同時保留向量資料，支援批次處理，且跨平台運作，確保工程與建築工作流程得到可靠的結果。
- Speed: 在一般雲端 VM 上，將 300 頁 DGN 轉換為 PNG 所需時間少於 12 秒。
- Accuracy: 以 99.9 % 的忠實度保留向量幾何、圖層與點陣圖。
- Scalability: 支援非同步與平行處理，讓您每天可處理上千個檔案。
- Cross‑platform: 可在 Windows、Linux 與 macOS 上搭配 .NET Core 執行。
前置條件
- Required library: GroupDocs.Conversion for .NET（透過 NuGet 安裝）。
- Development environment: Visual Studio 2022 或任何支援 .NET 6+ 的 IDE。
- Basic C# knowledge: 熟悉命名空間、類別與非同步模式。
如何安裝 GroupDocs.Conversion？
安裝 SDK 只需透過 NuGet 即可。此套件包含所有必要的二進位檔與相依性，讓您在將其加入專案後即可立即開始轉換檔案。您可以選擇使用 Package Manager Console 或 .NET CLI，兩者皆會取得最新穩定版並整合至建置流程中。
Package Manager Console
Install-Package GroupDocs.Conversion -Version 25.3.0
.NET CLI
dotnet add package GroupDocs.Conversion --version 25.3.0
加入套件後，請從 GroupDocs 官方網站取得試用或正式授權（purchase page），或申請臨時評估授權（temporary license），並將授權金鑰寫入應用程式設定。
如何將 dgn 轉換為 png？
使用 Converter 實例載入 DGN 檔案，設定 PNG 選項，然後呼叫 Convert 方法。API 會將每一頁串流至 MemoryStream，您可將其寫入磁碟或回傳給客戶端。此方式即使在處理大型圖紙時亦能保持低記憶體使用量。
如何在 .NET 專案中設定 GroupDocs.Conversion？
設定步驟包括加入授權金鑰，並建立指向來源檔案的 Converter 實例。此動作會讓 SDK 準備好執行轉換，並確保所有操作遵守授權條款。Converter 類別是管理檔案載入與轉換的核心元件。
using GroupDocs.Conversion;
// Initialize a converter object with the path to your DGN file
string dgnFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.dgn";
Converter converter = new Converter(dgnFilePath);
如何載入 DGN 檔案以進行轉換？
透過以檔案路徑建立 Converter 來載入 DGN 檔案。此步驟會驗證檔案並為後續的轉換操作做好準備。Converter 類別負責開啟來源文件並公開其頁面供處理。
string dgnFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.dgn";
// Load the DGN file using GroupDocs.Conversion's Converter class
Converter converter = new Converter(dgnFilePath);
如何設定 PNG 轉換選項？
PNG 轉換設定透過 ImageConvertOptions 物件定義，您可以在此指定輸出格式、解析度與視覺屬性。調整這些選項即可控制最終影像的品質與大小。ImageConvertOptions 類別封裝所有影像輸出的可設定參數，例如 DPI、背景顏色與頁面尺寸。
using GroupDocs.Conversion.Options.Convert;
// Initialize image conversion options with desired output format
ImageConvertOptions options = new ImageConvertOptions
{
Format = GroupDocs.Conversion.FileTypes.ImageFileType.Png
};
如何執行轉換並儲存 PNG 檔案？
呼叫 Converter 的 Convert 方法，傳入選項與建立每頁串流的委派，即可觸發轉換。此方法會逐頁處理文件，並將 PNG 資料寫入提供的串流中。Convert 方法負責使用指定的選項，將來源格式實際轉換為目標格式。
using System.IO;
string outputFolder = "YOUR_OUTPUT_DIRECTORY";
string outputFileTemplate = Path.Combine(outputFolder, "converted-page-{0}.png");
// Define a method to create file streams for each page being converted
Func<SavePageContext, Stream> getPageStream = savePageContext =>
new FileStream(string.Format(outputFileTemplate, savePageContext.Page), FileMode.Create);
// Perform the conversion from DGN to PNG using the Converter object and options defined earlier
converter.Convert(getPageStream, options);
實務使用案例
- 建築事務所 與沒有 CAD 軟體的客戶分享設計快照。
- 施工經理 將 PNG 預覽嵌入專案管理工具，以便快速視覺檢查。
- 行銷團隊 提取高解析度影像製作手冊與線上作品集，且不會洩漏原始 CAD 檔。
效能技巧
- 在完成後立即釋放
Converter物件，以釋放非受控資源。 - 處理大量檔案時，於 Web API 中使用非同步轉換（
ConvertAsync），以免佔用請求執行緒。 - 監控 CPU 與記憶體使用情況；對於大於 200 MB 的檔案，建議分批處理頁面。
常見問題
Q: 除了 DGN 與 PNG，GroupDocs.Conversion 還能處理哪些格式？
A: 它支援超過 100 種格式，包括 PDF、DOCX、XLSX、PPTX、SVG、JPEG、BMP，以及多種 CAD 格式如 DWG 與 DXF。
Q: 如何處理受密碼保護的 DGN 檔案？
A: 在 Converter 建構子中透過 LoadOptions 參數傳入密碼；SDK 會在轉換前解密檔案。
Q: 我可以在 Linux 容器中執行轉換嗎？
A: 可以，GroupDocs.Conversion for .NET 完全相容於 Linux 上的 .NET Core，您亦可使用 Docker 將服務容器化。
Q: 單次請求可轉換的頁數有上限嗎？
A: 沒有硬性上限，但對於非常大的圖紙（500 頁以上），建議分批處理頁面，以避免長時間執行的請求。
Q: 哪裡可以取得臨時評估授權？
A: 前往 GroupDocs 官方網站申請試用授權；有效期為 30 天，並啟用所有轉換功能。
最後更新： 2026-06-25
測試版本： GroupDocs.Conversion 25.3.0 for .NET
作者： GroupDocs
