如何高效使用 GroupDocs Conversion .NET 将 DGN 文件转换为 TEX 格式
將 DGN 文件轉換為 TEX 格式是需要將技術圖紙嵌入 LaTeX 為基礎文件的工程師常見的難題。在本教學中，您將看到 GroupDocs Conversion .NET 如何僅用幾行 C# 代碼完成此轉換。我們將逐步說明安裝、授權、路徑管理以及效能技巧，讓您能自信地將此工作流程整合到任何 .NET 專案中。
快速解答
- 什麼函式庫負責 DGN → TEX 轉換？ GroupDocs Conversion .NET.
- 哪個 NuGet 指令可安裝此函式庫？
dotnet add package GroupDocs.Conversion. - 生產環境是否需要授權？ 是 – 商業授權可移除試用限制。
- 我可以批次轉換多個 DGN 檔案嗎？ 當然可以；將程式碼包在迴圈中。
- 轉換是否具備記憶體效率？ 是的，它會串流檔案，且不會一次載入整個文件至記憶體。
GroupDocs Conversion .NET 是什麼？
GroupDocs Conversion .NET 是一個伺服器端 API，能在不需外部應用程式的情況下轉換超過 70 種文件與影像格式。它提供流暢且型別安全的 .NET 介面，支援 .NET Framework 與 .NET Core，適合自動化 CAD 流程。
為何使用 GroupDocs Conversion .NET 進行 DGN → TEX 轉換？
GroupDocs Conversion .NET 提供高效能串流、精確的 CAD 圖層渲染，且免除伺服器上安裝 MicroStation 或 LaTeX 的需求。它支援 DGN 輸入，產生保留線條粗細與註解的 TEX 輸出，並可整合至 CI/CD 流程，以實現全自動文件產生。
前置條件
- 函式庫與相依性： GroupDocs.Conversion for .NET (Version 25.3.0 或更新版本)。
- 開發環境： .NET 6 SDK 或更新版本（或 .NET Framework 4.7.2）。
- 知識需求： 基本的 C# 語法與檔案系統處理。
安裝 GroupDocs Conversion
您可以透過 NuGet 套件管理員主控台或 .NET CLI 來加入此套件。
NuGet 套件管理員主控台：
Install-Package GroupDocs.Conversion -Version 25.3.0
.NET CLI：
dotnet add package GroupDocs.Conversion --version 25.3.0
取得授權
GroupDocs 提供免費試用、評估用暫時授權，以及完整的商業授權。取得授權金鑰後，請在應用程式啟動時初始化一次：
GroupDocs.Conversion.License lic = new GroupDocs.Conversion.License();
lic.SetLicense("Path to License File.lic");
實作指南
如何將 DGN 檔案轉換為 TEX 格式？
Converter 類別載入來源文件並為轉換做準備。TexConvertOptions 指定 TEX 專屬設定，Convert 方法則寫入輸出檔案。
// Direct answer (40–70 words)
var converter = new GroupDocs.Conversion.Converter("sample.dgn");
var texOptions = new GroupDocs.Conversion.Options.Convert.TexConvertOptions();
converter.Convert("output.tex", texOptions);
說明：
Converter類別是代表單一來源文件的入口點。TexConvertOptions（ConvertOptions的子類別）告訴引擎產生相容 LaTeX 的輸出。Convert方法將 TEX 檔寫入指定路徑。
載入來源 DGN 檔案
Converter 懶惰地讀取 DGN 檔案，降低記憶體使用，同時提供轉換功能的存取。
string documentDirectory = "YOUR_DOCUMENT_DIRECTORY"; // Replace with actual path
string outputDirectory = "YOUR_OUTPUT_DIRECTORY"; // Replace with desired output path
設定 TEX 專屬選項
TexConvertOptions 定義 DGN 圖面如何轉譯為 LaTeX 指令，例如縮放與圖層處理。您可以調整 Scale 或 IncludeLayers 等屬性，以微調輸出。
using (var converter = new Converter(Path.Combine(documentDirectory, "sample.dgn")))
{
// Configure conversion options for TEX format
PageDescriptionLanguageConvertOptions options = new PageDescriptionLanguageConvertOptions
{
Format = PageDescriptionLanguageFileType.Tex
};
// Set the output file path and perform conversion
string outputFile = Path.Combine(outputDirectory, "dgn-converted-to.tex");
converter.Convert(outputFile, options);
}
管理轉換的檔案路徑
Path.Combine 安全地建立跨平台檔案路徑，檢查寫入權限可防止執行時拋出 UnauthorizedAccessException。
if (!Directory.Exists(documentDirectory))
{
Directory.CreateDirectory(documentDirectory);
}
if (!Directory.Exists(outputDirectory))
{
Directory.CreateDirectory(outputDirectory);
}
疑難排解技巧
- 確認
sample.dgn是否存在於來源資料夾；若檔案缺失會拋出FileNotFoundException。 - 確保應用程式對輸出目錄具有寫入權限，否則會看到
UnauthorizedAccessException。 - 若轉換失敗並顯示「Unsupported format」，請確認您使用的是已加入 DGN 支援的 GroupDocs Conversion 25.3.0 或更新版本。
實務應用
- 自動化報告產生： 將 CAD 圖面轉換為 TEX，並直接嵌入航空或土木工程專案的 LaTeX 報告中。
- 持續整合流程： 在 CI/CD 中加入轉換步驟，確保每次提交都攜帶最新的技術插圖。
- 跨平台資料交換： 與使用 TeX 編輯器的協作者共享 TEX 檔，免除專屬 CAD 檢視器的需求。
效能考量
- 記憶體管理： 將
Converter實例包在using區塊中，以確保釋放。 - 批次處理： 迭代 DGN 檔案目錄，盡可能重複使用單一
Converter實例，以減少開銷。 - 效能分析： 使用 .NET 的
DiagnosticSource或效能分析工具找出 I/O 瓶頸；大多數 10 頁圖面的轉換可在 2 秒內完成。
常見問題
Q: 什麼是 DGN 檔案？
A: DGN 檔案是 MicroStation 的原生 CAD 圖面格式，廣泛用於土木與基礎建設工程。
Q: 我可以一次轉換多個 DGN 檔案嗎？
A: 可以 – 將轉換程式碼放在遍歷資料夾中所有 .dgn 檔案的 foreach 迴圈內。
Q: 如何排除轉換錯誤？
A: 檢查檔案路徑、確認授權已載入，並確保使用的是包含最新 DGN 解析器的 GroupDocs Conversion 25.3.0 或更新版本。
Q: GroupDocs Conversion .NET 還支援哪些其他格式？
A: 超過 70 種格式，包括 PDF、DOCX、PPTX、DXF、SVG，以及 PNG、JPEG 等影像類型。
Q: 此函式庫是否相容於 .NET Core 與 .NET Framework？
A: 是 – 它可在 .NET Framework 4.7.2 以上、.NET Core 3.1 以上，以及 .NET 5/6/7 上執行。
結論
您現在已擁有使用 GroupDocs Conversion .NET 將 DGN 檔案轉換為 TEX 的完整、可投入生產的解決方案。此步驟涵蓋安裝、授權、路徑處理與效能調校，讓您有信心將此工作流程嵌入任何以 CAD 為中心的 .NET 應用程式。探索更多轉換選項、嘗試批次處理，並將 API 整合至現有的 CI 流程，以實現全自動文件化。
最後更新： 2026-06-30
測試版本： GroupDocs.Conversion 25.3.0 for .NET
作者： GroupDocs
