如何在 C# 中將 CSV 檔案轉換為列表

步驟 1：建立一個新的 C# 項目

1.開啟 Visual Studio：在您的電腦上啟動 Visual Studio。 2.建立新項目：點選"建立新項目"。 這將打開一個窗口，您可以在其中選擇項目類型。 3.選擇項目類型：為了簡單起見，選擇"控制台應用程式（.NET Core）"作為您的專案類型。 4.為您的專案命名：將您的專案命名為CSVFileReader 。 5.選擇位置：選擇設備上的適當位置來儲存此項目。 6.產生專案：按一下"建立"以初始化您的新 C# 專案。

步驟 2：安裝 IronXL 庫

1.開啟 NuGet 套件管理員：在 Visual Studio 中，前往"工具"選單，然後選擇"NuGet 套件管理員"，再選擇"管理解決方案的 NuGet 套件..."。 2.瀏覽 IronXL：點選"瀏覽"選項卡，搜尋"IronXL.Excel"。

[如何在 C# 中將 CSV 檔案轉換為清單：圖 1 - IronXL](/static-assets/excel/blog/csharp-read-csv-file-into-list-tutorial/csharp-read-csv-file-into-list-tutorial-1.webp)

3.安裝 IronXL：在搜尋結果中找到 IronXL 軟體包，選擇它，然後按一下"安裝"。確保您同意所有許可協議並查看更改內容。 4.檢查安裝：安裝完成後，您應該在項目的引用中看到 IronXL 的引用。

現在，您的CSVFileReader專案已設定好 IronXL 庫，您可以開始在 C# 中讀取和處理 CSV 檔案了。 此設定構成了我們將在本教程後續章節中進行的 CSV 讀取任務的基礎。

步驟 1：指定檔案路徑

在讀取任何資料之前，我們需要知道 CSV 檔案位於哪裡。 在Main方法中定義一個變數來儲存檔案路徑。

string filename = "csvfile.csv"; // Replace with your actual file path

string filename = "csvfile.csv"; // Replace with your actual file path

步驟 2：載入 CSV 文件

IronXL 可以輕鬆載入 CSV 檔案。使用WorkBook.LoadCSV方法將 CSV 檔案讀取到WorkBook物件中。

var csv = WorkBook.LoadCSV(filename);

var csv = WorkBook.LoadCSV(filename);

步驟 3：定義資料結構

建立一個類別來表示 CSV 檔案中的資料結構。例如，如果 CSV 檔案包含人員資訊，則可以定義一個Person類，如下所示：

public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
}

public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
}

步驟 4：解析 CSV 數據

在此步驟中，我們將解析 CSV 檔案並填入List<Person>利用這些數據。 我們使用 IronXL 來處理 CSV 讀取，關鍵是要正確處理 CSV 的每一行，考慮到標題和任何可能的空白行。 以下是代碼的詳細分解：

List<Person> people = new List<Person>();
bool isFirstRow = true; // Add a flag to check for the first row
foreach (var row in csv.WorkSheets[0].Rows)
{
    if (isFirstRow)
    {
        isFirstRow = false; // Set the flag to false after skipping the first row
        continue;
    }
    if (row.IsEmpty) continue; // Skip empty rows
    var cells = row.ToArray();
    var person = new Person()
    {
        Name = cells[0].StringValue,
        Age = int.Parse(cells[1].StringValue) // Ensure this is a numeric value
    };
    people.Add(person);
}

List<Person> people = new List<Person>();
bool isFirstRow = true; // Add a flag to check for the first row
foreach (var row in csv.WorkSheets[0].Rows)
{
    if (isFirstRow)
    {
        isFirstRow = false; // Set the flag to false after skipping the first row
        continue;
    }
    if (row.IsEmpty) continue; // Skip empty rows
    var cells = row.ToArray();
    var person = new Person()
    {
        Name = cells[0].StringValue,
        Age = int.Parse(cells[1].StringValue) // Ensure this is a numeric value
    };
    people.Add(person);
}

在這個解析過程中，我們先初始化一個List<Person>儲存解析後的數據，並使用布林標誌isFirstRow跳過 CSV 檔案的標題行。 foreach循環遍歷 CSV 檔案的每一行。在第一次迭代中，會識別並跳過標題行，從而確保只處理資料行。 然後我們使用row.IsEmpty檢查每一行，以確保它不為空。 這一步驟對於避免解析過程中出現空白行錯誤至關重要。

對於每一行數據，我們將該行轉換為單元格數組（ row.ToArray() ），然後使用此數據建立Person物件。 正確分析和轉換資料類型至關重要，例如將"年齡"字串轉換為整數。 解析後的Person物件隨後被加入到我們的people清單中。這種方法確保只處理和儲存有效的資料行，從而有效處理諸如數值列中出現非數字字串或意外的空白行等潛在問題。

步驟五：展示數據

將 CSV 資料解析到我們的List<Person>中List<Person>下一個重要步驟是展示和驗證資料。 這不僅有助於確保解析成功，還可以讓我們觀察輸出結果並進行快速的資料品質檢查。 以下是實作方法：

foreach (var person in people)
{
    Console.WriteLine($"Name: {person.Name}, Age: {person.Age}");
}

foreach (var person in people)
{
    Console.WriteLine($"Name: {person.Name}, Age: {person.Age}");
}

以下是完整的 Program.cs 程式碼：

using IronXL;
using System;
using System.Collections.Generic;

public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
}

class Program
{
    static void Main(string[] args)
{
    string filename = @"C:\Users\tayya\Downloads\sample_data.csv"; // Replace with your actual file path
    var csv = WorkBook.LoadCSV(filename);
    List<Person> people = new List<Person>();
    bool isFirstRow = true; // Add a flag to check for the first row
    foreach (var row in csv.WorkSheets[0].Rows)
    {
        if (isFirstRow)
        {
            isFirstRow = false; // Set the flag to false after skipping the first row
            continue;
        }
        if (row.IsEmpty) continue; // Skip empty rows
        var cells = row.ToArray();
        var person = new Person()
        {
            Name = cells[0].StringValue,
            Age = int.Parse(cells[1].StringValue) // Ensure this is a numeric value
        };
        people.Add(person);
    }
    foreach (var person in people)
    {
        Console.WriteLine($"Name: {person.Name}, Age: {person.Age}");
    }
}

using IronXL;
using System;
using System.Collections.Generic;

public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
}

class Program
{
    static void Main(string[] args)
{
    string filename = @"C:\Users\tayya\Downloads\sample_data.csv"; // Replace with your actual file path
    var csv = WorkBook.LoadCSV(filename);
    List<Person> people = new List<Person>();
    bool isFirstRow = true; // Add a flag to check for the first row
    foreach (var row in csv.WorkSheets[0].Rows)
    {
        if (isFirstRow)
        {
            isFirstRow = false; // Set the flag to false after skipping the first row
            continue;
        }
        if (row.IsEmpty) continue; // Skip empty rows
        var cells = row.ToArray();
        var person = new Person()
        {
            Name = cells[0].StringValue,
            Age = int.Parse(cells[1].StringValue) // Ensure this is a numeric value
        };
        people.Add(person);
    }
    foreach (var person in people)
    {
        Console.WriteLine($"Name: {person.Name}, Age: {person.Age}");
    }
}

程式碼輸出

運行該文件後，它會在控制台中顯示列表資料：

如何在 C# 中將 CSV 檔案轉換為清單：圖 2 - 清單輸出