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

包管理器UI提供了一個瀏覽功能，顯示在NuGet網站上可用的包庫列表。輸入"IronXL"，如下圖所示以查找IronXL包。 您還可以探索IronXL提供的相關Excel操作功能。

在Visual Studio的NuGet包管理器中顯示的IronXL.Excel程式庫，使開發者在.NET應用程式中讀取、生成和編輯Excel文件。 該包顯示有250K次下載和版本2022.9.9454準備安裝

選擇IronXL.Excel包並點擊安裝按鈕將其新增到專案中。 安裝過程將自動處理所有依賴項並配置您的專案以供Excel文件操作。

何時應使用Visual Studio的命令行？

在Visual Studio選單中，前往工具 > NuGet包管理器 > 點擊包管理器控制台。 這種方法較受那些熟悉命令行介面或需要在構建腳本中自動化安裝過程的開發人員的歡迎。

在Visual Studio中打開NuGet包管理器控制台以安裝CSV解析程式庫

包管理器控制台將出現在螢幕底部。 輸入以下命令並按回車。 IronXL將被安裝。 這種方法在您需要安裝特定版本，或在Azure的部署腳本或AWS環境中工作時特別有用。

Install-Package IronXL.Excel

包管理器控制台顯示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: ";");
    }
}

Imports IronXL

Class Program
    Shared Sub Main()
        ' Load the XLSX file into a WorkBook object
        ' The Load method automatically detects the file format
        Dim wb As WorkBook = 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: ";")
    End Sub
End Class

執行完成後，將建立一個名為Parsed CSV.csv的新文件。 您可以在任何編輯器或閱讀器中讀取CSV文件。您也可以將CSV資料再導入Excel中進行進一步操作。 下圖顯示了上述命令的輸出—我們生成的CSV資料。 在輸出文件中，雙引號代表粗體值。

圖7：由SaveAsCsv方法生成的CSV輸出，顯示以逗號分隔格式轉換的Excel資料

將XLS文件轉換為CSV的步驟是什麼？

在此範例中，我們將看到如何將XLS文件轉換為CSV格式。 該過程與XLSX轉換相同，展現了IronXL在處理不同Excel文件格式時的靈活性。

首先，讓我們建立一個可以轉換為CSV格式的XLS範例文件。 請注意，XLS是舊的Excel格式，但IronXL不費吹灰之力地處理它與現代格式：

圖8：展示具有自動計算的庫存資料結構的範例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");
    }
}

Imports IronXL

Class Program
    Shared Sub Main()
        ' Load the XLS file into a WorkBook object
        ' IronXL automatically handles the older XLS format
        Dim wb As WorkBook = 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
        ' Dim ws As WorkSheet = wb.GetWorkSheet("Sheet1")
        ' ws.SaveAsCsv("Example2.csv")
    End Sub
End Class

在上述程式碼執行完成後，您將擁有一個新生成的CSV文件。對於更複雜的情況，您可能希望選擇特定範圍或在導出前對資料進行排序。

在WordPad中打開的範例CSV文件，顯示格式良好的以逗號分隔的資料，帶有標題和多個產品條目

如何從TSV格式解析CSV文件？

電子表格應用通常使用TSV文件或Tab-Separated Values文件在資料庫之間傳輸資料。 它保存了一個資料表，其中資料列由制表符分隔，每條記錄位於不同的行上。當您的資料包含可能干擾CSV解析的逗號時，TSV文件特別有用。

IronXL提供CSV解析器以從TSV格式解析CSV文件，以便更好地管理資料。 轉換過程很簡單，並在整個過程中保持資料完整性。

讓我們從範例開始吧。 首先，我們將建立一個包含學生資料的TSV文件：

以Microsoft Word展示的Tab分隔學生資料範例，展示TSV文件的結構，包含名稱、電子郵件、R-NO和成績的列

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");
    }
}

Imports IronXL

Class Program
    Shared Sub Main()
        ' Load the TSV file into a WorkBook object
        ' IronXL automatically detects tab-separated format
        Dim wb As WorkBook = 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
        ' Dim wb As WorkBook = WorkBook.LoadCSV("TSV.tsv", delimiter:=vbTab)
    End Sub
End Class

以下是CSV格式的輸出。 請注意IronXL如何在保持資料結構的同時，正確地將制表符分隔的值轉換為逗號分隔的值：

WordPad中打開的範例CSV文件，顯示學生記錄，包含用逗號分隔的名稱、電子郵件、學號和成績字段