C# CSV 解析器（逐步教學）

我應該使用 Visual Studio NuGet 套件管理器嗎？

Visual Studio 中提供了 NuGet 套件管理器 UI，可以直接將套件安裝到專案中。 對於喜歡視覺化介面並希望在安裝前查看軟體包詳細資訊的開發人員來說，這種方法特別有用。 下面的截圖顯示如何開啟它。

Visual Studio 介面顯示"工具"功能表已展開，"NuGet 套件管理器"選項已高亮顯示，且二級選單顯示"管理解決方案的 NuGet 套件"已選取。若要存取 Visual Studio 中的 NuGet 套件管理器，請導覽至"工具">"NuGet 套件管理器">"管理解決方案的 NuGet 套件"。

套件管理器使用者介面提供了一個瀏覽功能，用於顯示 NuGet 網站上可用的套件庫清單。輸入"IronXL"（如下圖）即可找到 IronXL 套件。 您也可以探索 IronXL 提供的相關 Excel 處理功能。

Visual Studio 的 NuGet 套件管理器介面顯示了 IronXL.Excel 套件的搜尋結果，其中已選擇版本 2022.9.9454 安裝到名為"Create PDF"的 C# 專案中。 Visual Studio 中的 NuGet 套件管理器顯示了 IronXL.Excel 程式庫，該程式庫使開發人員能夠在 .NET 應用程式中讀取、產生和編輯 Excel 檔案。 軟體包顯示下載量已達 25 萬次，版本為 2022.9.9454，可供安裝。

選擇IronXL.Excel程式包，然後按一下"安裝"按鈕將其新增至專案。 安裝過程將自動處理所有依賴項，並配置您的專案以進行Excel 文件操作。

何時應該使用 Visual Studio 命令列？

在 Visual Studio 功能表中，前往"工具" > "NuGet 套件管理器" >按一下"套件管理器控制台" 。 對於熟悉命令列介面或需要在建置腳本中自動化安裝過程的開發人員來說，這種方法是更優的選擇。

Visual Studio 介面顯示"工具"功能表已展開，"NuGet 套件管理器"選項已高亮顯示，底部開啟了"套件管理器控制台"視窗。在 Visual Studio 中開啟 NuGet 套件管理器控制台以安裝 CSV 解析庫。

程式包管理器控制台將顯示在螢幕底部。 輸入以下指令並按下回車鍵。 將安裝IronXL。 當您需要安裝特定版本或使用Azure或AWS 環境的部署腳本時，此方法特別有用。

Install-Package IronXL.Excel

Visual Studio 中的套件管理器控制台顯示 IronXL.Excel NuGet 套件的安裝過程，並顯示下載成功的確認訊息。套件管理器控制台顯示 IronXL.Excel 版本 2022.11.10251 已成功安裝，並顯示了套件還原程序以及從 NuGet 儲存庫下載的確認資訊。

如何將XLSX檔轉換為CSV檔？

開啟 Microsoft Excel 並建立一個新的 XLSX 檔案。在檔案的行和列中填入一些模擬資料。 在生產環境中，您可能需要使用 IronXL以程式設計方式建立 Excel 檔案。 下圖顯示了本教程中所有轉換所使用的檔案。

圖 6： Excel 範例數據，展示了一個簡單的庫存表，包含"物品"、"數量"、"價格"和"總計"四列，其中包含斧頭、鋼筆、充電器和耳機的數據。此範例資料展示了一個基本的庫存結構，將用於演示 C# 中的 CSV 解析。

文件準備就緒後，編寫以下範例程式碼並執行程式。 IronXL 在內部處理所有複雜的解析，包括正確處理特殊字元和資料類型：

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLSX file into a WorkBook object
        // The Load method automatically detects the file format
        WorkBook wb = WorkBook.Load("test.xlsx");

        // Save the WorkBook as a CSV file
        // This method handles all formatting and conversion automatically
        wb.SaveAsCsv("Parsed CSV.csv");

        // Optional: Save with custom delimiter
        // wb.SaveAsCsv("Parsed CSV.csv", delimiter: ";");
    }
}

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLSX file into a WorkBook object
        // The Load method automatically detects the file format
        WorkBook wb = WorkBook.Load("test.xlsx");

        // Save the WorkBook as a CSV file
        // This method handles all formatting and conversion automatically
        wb.SaveAsCsv("Parsed CSV.csv");

        // Optional: Save with custom delimiter
        // wb.SaveAsCsv("Parsed CSV.csv", delimiter: ";");
    }
}

執行完成後，將建立一個名為Parsed CSV.csv的新檔案。 您可以使用任何您喜歡的編輯器或閱讀器開啟 CSV 檔案。您也可以將 CSV 資料重新匯入 Excel進行進一步處理。 下圖顯示了上述命令的輸出結果—我們產生的 CSV 資料。 在輸出檔中，雙引號表示粗體值。

圖 7：使用 WorkBook.SaveAsCsv方法產生的WorkBook輸出，以逗號分隔格式顯示SaveAsCsv後的 Excel 資料。

如何將 XLS 檔案轉換為 CSV 檔案？

在這個例子中，我們將看到如何將 XLS 檔案轉換為 CSV 格式。 這個過程與 XLSX 轉換相同，這反映了 IronXL 在處理不同 Excel 檔案格式方面的多功能性。

首先，我們建立一個範例 XLS 文件，然後將其轉換為 CSV 格式。 請注意，XLS 是較舊的 Excel 格式，但 IronXL 可以無縫地處理它以及現代格式：

圖 8為一個範例 Excel 文件，展示了庫存清單，包含"物品"、"數量"、"價格"和"總計"四列，列出了斧頭、筆、充電器、耳機和鋸子等各種工具及其數量和計算出的總計，總計為 1239。此範例 Excel 檔案演示了庫存資料結構及其自動計算功能，可以使用 C# CSV 庫進行解析。

接下來，我們將執行以下程式碼區塊，將範例 XLS 檔案轉換為 CSV 檔案。 IronXL 在轉換過程中會保持資料完整性，包括公式和計算結果：

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLS file into a WorkBook object
        // IronXL automatically handles the older XLS format
        WorkBook wb = WorkBook.Load("XLS.xls");

        // Save the WorkBook as a CSV file
        // All formulas are evaluated and results are exported
        wb.SaveAsCsv("Example2.csv");

        // Optional: Export specific worksheet
        // WorkSheet ws = wb.GetWorkSheet("Sheet1");
        // ws.SaveAsCsv("Example2.csv");
    }
}

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLS file into a WorkBook object
        // IronXL automatically handles the older XLS format
        WorkBook wb = WorkBook.Load("XLS.xls");

        // Save the WorkBook as a CSV file
        // All formulas are evaluated and results are exported
        wb.SaveAsCsv("Example2.csv");

        // Optional: Export specific worksheet
        // WorkSheet ws = wb.GetWorkSheet("Sheet1");
        // ws.SaveAsCsv("Example2.csv");
    }
}

上述程式碼執行完畢後，您將獲得一個新產生的 CSV 檔案。對於更複雜的場景，您可能需要在匯出之前選擇特定範圍或對資料進行排序。

! WordPad 視窗顯示一個 CSV 文件，其中包含商品、數量、價格和總計，包括 AXE、鋼筆、充電器、耳機和鋸子的條目。範例 CSV 檔案在WordPad中打開，顯示格式正確的逗號分隔數據，帶有標題和多個產品條目。

如何從 TSV 格式解析 CSV 檔案？

電子表格應用程式經常使用 TSV 檔案（製表符分隔值檔案）在資料庫之間傳輸資料。 它會保存一個資料表，資料列之間用製表符分隔，每筆記錄佔一行。當資料中包含可能幹擾 CSV 解析的逗號時，TSV 檔案尤其有用。

IronXL 提供了一個 CSV 解析器，用於將 TSV 格式的文件解析為 CSV 文件，以便更好地進行資料管理。 轉換過程簡單直接，並能始終保持資料完整性。

讓我們從例子開始。 首先，我們將建立一個包含學生資料的TSV檔案：

！ Microsoft Word 文檔，顯示一個包含學生資料的表格，資料包括姓名、電子郵件地址、學號 (R-NO) 和字母等級，格式為製表符分隔值 (TSV)。範例：在 Microsoft Word 中顯示的製表符分隔的學生數據，展示了 TSV 文件的結構，其中包含姓名、電子郵件地址、學號和等級列。

using IronXL;

class Program
{
    static void Main()
    {
        // Load the TSV file into a WorkBook object
        // IronXL automatically detects tab-separated format
        WorkBook wb = WorkBook.Load("TSV.tsv");

        // Save the WorkBook as a CSV file
        // Tabs are converted to commas automatically
        wb.SaveAsCsv("Example3.csv");

        // Alternative: Load with explicit delimiter specification
        // WorkBook wb = WorkBook.LoadCSV("TSV.tsv", delimiter: "\t");
    }
}

using IronXL;

class Program
{
    static void Main()
    {
        // Load the TSV file into a WorkBook object
        // IronXL automatically detects tab-separated format
        WorkBook wb = WorkBook.Load("TSV.tsv");

        // Save the WorkBook as a CSV file
        // Tabs are converted to commas automatically
        wb.SaveAsCsv("Example3.csv");

        // Alternative: Load with explicit delimiter specification
        // WorkBook wb = WorkBook.LoadCSV("TSV.tsv", delimiter: "\t");
    }
}

以下是CSV格式的輸出結果。 請注意 IronXL 是如何在保持資料結構不變的情況下，將製表符分隔的值正確轉換為逗號分隔的值的：

! WordPad 文件顯示了一個 CSV 文件，其中包含學生數據，包括姓名、電子郵件、學號和成績，並以逗號作為分隔符號。範例 CSV 檔案在WordPad中打開，顯示了學生記錄，其中包含姓名、電子郵件、學號和成績字段，字段之間以逗號分隔。