C# CSV 解析器（分步）教程

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

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

Access the NuGet Package Manager in Visual Studio by navigating to Tools > NuGet Package Manager > Manage NuGet Packages for Solution

套件管理器使用者介面提供了一個瀏覽功能，用於顯示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包管理器控制台以安裝 CSV 解析庫

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

Install-Package IronXL.Excel

NuGet管理器控制台顯示IronXL .Excel 版本 2022.11.10251 已安裝資料庫的資料

如何將XLSX檔轉換為CSV檔？

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

圖 6：範例 Excel 數據，顯示一個基本的庫存結構，該結構將用於分析 CSV 中的 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 資料。 在輸出檔中，雙引號表示粗體值。

在寫字板中開啟的CSV檔案顯示產品數據，標題分別為"商品"、"數量"、"價格"和"總計"，其中包含AXE、鋼筆、充電器和耳機的條目及其各自的值。 SaveAsCsv方法產生的CSV輸出，以逗號分隔格式顯示轉換後的Excel資料。

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

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

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

Microsoft Excel 電子表格，顯示物品庫存，包含"物品"、"數量"、"價格"和"總計"四列，列出了斧頭、筆、充電器、耳機和鋸子等各種工具及其數量和計算出的總計，總計為 1239

接下來，我們將執行以下程式碼區塊，將IronXLXLS 檔案轉換為 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 檔案。對於更複雜的場景，您可能需要在匯出之前選擇特定範圍或對資料進行排序。

示例 CSV 文件在 @@ --CODE-805--@IMG-219-EG--@@示例 CSV 文件在 WordPadIMG-219-EG--@@範例 CSV 文件在 WordPad 中打開，數據格式包含的數據編號

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

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

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

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

Microsoft Word 中顯示的製表符分隔學生資料範例，展示了 TSV 檔案的結構，其中包含姓名、電子郵件地址、學號 (R-NO) 和等級 (Grade) 欄位。

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是如何在保持資料結構不變的情況下，將製表符分隔的值正確轉換為逗號分隔的值的：

範例 CSV 檔案在 WordPad 中打開，顯示學生記錄，欄位包括姓名、電子郵件、學號和成績，以逗號分隔。