使用 GroupDocs.Conversion for .NET 將 CAD 轉換為 CSV
將 CAD 檔案轉換為 CSV 是在需要從技術圖紙中提取表格資料以進行分析、報告或遷移時的常見需求。在本教學中,您將學習如何使用 GroupDocs.Conversion for .NET 迅速 將 CAD 轉換為 CSV,一步一步完成。
快速解答
- 什麼程式庫負責轉換? GroupDocs.Conversion for .NET.
- 正在讀取的檔案格式是什麼? Design Web Format (DWF) – 原生 CAD 格式。
- 輸出格式是什麼? Comma‑Separated Values (CSV) 方便匯入試算表。
- 需要多少行程式碼? 安裝程式庫後少於十行。
- 生產環境需要授權嗎? 是 – 非試用使用需購買商業授權。
什麼是「將 CAD 轉換為 CSV」?
「Convert CAD to CSV」 指的是從 CAD 圖紙(例如 DWF)中提取幾何或屬性資料,並寫入純文字、逗號分隔的表格,可由 Excel、Power BI 或任何資料處理工具開啟。此轉換讓分析師能執行統計計算、產生報告,並將圖紙資訊整合至資料庫,而無需專業 CAD 軟體。
為什麼使用 GroupDocs.Conversion for .NET?
GroupDocs.Conversion 支援 50+ 種輸入與輸出格式,可在不將整個文件載入記憶體的情況下處理數百頁的 CAD 檔案,並可在 .NET 6+、.NET 5+、.NET Core 3.1 以及傳統 .NET Framework 上執行。其 API 不需要外部 CAD 軟體,降低授權成本並簡化部署。
前置條件
在開始之前,請確認您具備以下條件:
- GroupDocs.Conversion for .NET 版本 25.3.0 或更新版本。
- C# 開發環境(Visual Studio 2022 或更新版本)。
- .NET 6 SDK(或任何受支援的 .NET 執行環境)。
- 取得有效的 GroupDocs 授權(試用或購買)。
必要的函式庫與相依性
- GroupDocs.Conversion for .NET – 核心轉換引擎。
- System.IO – 用於檔案路徑處理(內建)。
環境設定需求
您的作業系統必須是 Windows 10/11、macOS 12+,或支援目標 .NET 執行環境的 Linux 發行版。
知識前提
熟悉基本的 C# 語法、using 陳述式與檔案 I/O,將使教學流程更順暢。
設定 GroupDocs.Conversion for .NET
如何安裝程式庫?
您可以透過 NuGet 將 GroupDocs.Conversion 加入專案。
NuGet 套件管理員主控台
Install-Package GroupDocs.Conversion -Version 25.3.0
.NET CLI
dotnet add package GroupDocs.Conversion --version 25.3.0
取得授權步驟
- 免費試用: 先使用免費試用版以探索功能。
- 臨時授權: 若需要短期測試金鑰,請在此處取得臨時授權。
- 購買: 完整生產環境請從GroupDocs 購買頁面購買授權。
基本初始化與設定
ConversionConfig 類別保存轉換過程的設定。Converter 類別提供載入文件與執行轉換的方法。
using System;
using GroupDocs.Conversion;
class Program
{
static void Main()
{
string sourceFilePath = @"YOUR_DOCUMENT_DIRECTORY\\sample.dwf";
var converter = new Converter(sourceFilePath);
Console.WriteLine("GroupDocs.Conversion initialized successfully.");
}
}
如何使用 GroupDocs.Conversion for .NET 將 DWF 轉換為 CSV?
載入來源 DWF 檔案,設定 CSV 選項,然後呼叫 Convert 方法——整個轉換在一次方法呼叫中完成。此方式會自動提取圖層名稱、座標與屬性表格至結構良好的 CSV 檔,並確保任何嵌入的中繼資料在後續分析中得以保留。
載入 DWF 檔案
概觀
載入 DWF 檔案以備轉換。請依照以下步驟:
步驟 1:定義文件路徑
string sourceFilePath = @"YOUR_DOCUMENT_DIRECTORY\\sample.dwf";
確保 sourceFilePath 指向磁碟上已存在的 DWF 檔案。
步驟 2:使用 GroupDocs.Conversion 載入檔案
var converter = new Converter(sourceFilePath);
轉換 DWF 為 CSV
概觀
載入後,將 DWF 檔案轉換為 CSV 格式。
步驟 1:定義 CSV 檔案的輸出路徑
確保輸出目錄已存在,或以程式方式建立:
string outputFolder = @"YOUR_OUTPUT_DIRECTORY";
string outputFile = System.IO.Path.Combine(outputFolder, "dwf-converted-to.csv");
步驟 2:準備 CSV 格式的轉換選項
CsvConvertOptions 類別讓您自訂 CSV 輸出,例如分隔符與編碼。
using GroupDocs.Conversion.Options.Convert;
SpreadsheetConvertOptions options = new SpreadsheetConvertOptions { Format = GroupDocs.Conversion.FileTypes.SpreadsheetFileType.Csv };
步驟 3:執行轉換
以單一呼叫執行轉換;程式庫會處理分頁與資源清理。
converter.Convert(outputFile, options);
Console.WriteLine("Conversion completed successfully.");
疑難排解技巧
- 確認
sourceFilePath指向可讀取的 DWF 檔案。 - 確保
outputFolder已存在;可使用Directory.CreateDirectory建立。 - 若在大型圖紙上轉換失敗,請提升程序的記憶體上限或透過
ConversionConfig.EnableStreaming = true開啟串流模式。
實務應用
「將 CAD 轉換為 CSV」的實際應用情境包括:
- 建築資料分析: 將設計中繼資料匯出為 CSV,以進行統計分析或成本估算。
- 跨平台相容性: 將專屬 CAD 工具的資料轉移至 Excel 友善格式,供未安裝 CAD 軟體的利害關係人使用。
- 資料遷移專案: 自動化大量舊版 DWF 圖紙遷移至可直接匯入資料庫的 CSV 檔案。
效能考量
GroupDocs.Conversion 以串流方式處理檔案,讓您能在不耗盡記憶體的情況下處理 最高 1 GB 的 DWF 檔案。為獲得最佳速度:
- 在至少具備 4 GB 可用記憶體 的機器上執行轉換。
- 使用
using區塊確保Converter物件得以正確釋放。
最佳實踐:
using (var converter = new Converter(sourceFilePath))
{
// conversion code here
}
using (var converter = new Converter(sourceFilePath))
{
// Conversion code here
}
常見問題
Q: 如何將其他 CAD 格式(DWG、DXF)轉換為 CSV?
A: GroupDocs.Conversion 支援 DWG、DXF 與 DWF。只需更換來源檔案副檔名並使用相同的 CsvConvertOptions——API 會自動偵測格式。
Q: 我可以一次批次轉換多個 DWF 檔案嗎?
A: 可以。遍歷 DWF 檔案目錄,於 foreach 迴圈中對每個檔案呼叫轉換邏輯。
Q: 商業專案適用何種授權模式?
A: 任何生產部署皆需付費授權。試用金鑰僅供評估使用,且於 30 天後過期。
Q: 轉換是否保留圖層資訊?
A: 產生的 CSV 包含 “Layer” 欄位,記錄每個抽取實體的原始 CAD 圖層。
Q: 如何提升極大型圖紙的轉換速度?
A: 開啟串流 (ConversionConfig.EnableStreaming = true) 並在具 SSD 儲存的機器上執行,以降低 I/O 延遲。
結論
您現在已擁有完整、可投入生產的 將 CAD 轉換為 CSV 指南,使用 GroupDocs.Conversion for .NET。依照上述步驟,即可將此功能整合至任何 .NET 服務、桌面應用程式或自動化流程。
後續步驟
- 使用相同 API 嘗試其他輸出格式,例如 XLSX 或 JSON。
- 將 CSV 輸出與 Power BI 結合,建立 CAD 資料的即時儀表板。
- 在 GroupDocs 文件中檢視完整支援格式清單。
行動呼籲: 在您的下一個專案中實作範例程式碼,看看您能多快將複雜的 CAD 圖紙轉化為可行的資料!
最後更新: 2026-07-14
測試環境: GroupDocs.Conversion 25.3.0 for .NET
作者: GroupDocs
資源