跳過到頁腳內容
使用 IRONXL
如何在 C# 中導入 CSV 到 DataTable | IronXL

如何在C#中將CSV導入數據表

歡迎來到本篇關於使用IronXL將 CSV(逗號分隔值)檔案匯入 C# 中的DataTable 的入門教學。 本指南將為您提供易於遵循的方法,確保即使您是 C# 新手,也能輕鬆上手。 我們將涵蓋從搭建環境到編寫原始程式碼的每一個步驟。 在本教程結束時,您將清楚地了解如何使用文件讀取器和IronXL在 C# 中將 CSV 資料轉換為 DataTable、管理 DataTable 列以及處理 CSV 文件的各個方面。

先決條件

在深入探討之前,請確保您已準備好:

  • 具備 C# 基礎知識
  • 您的本機上已安裝 Visual Studio
  • IronXL庫,可透過NuGet套件管理器取得。

了解基礎知識

什麼是CSV檔案?

CSV 文件(逗號分隔值文件)是一種純文字文件,它使用特定的結構來排列表格資料。 CSV 是一種常見的資料交換格式,因為它簡單、緊湊,並且與眾多平台相容。 在 CSV 檔案中,資料以逗號分隔,每一行代表一個新的資料行,列標題通常位於第一行。

Understanding DataTables in C

DataTable 是 C# 中.NET函式庫的一部分,它表示記憶體中的單一資料表。 它由行和列組成,每一列可以是不同的資料類型。 DataTables 具有高度的靈活性,能夠以結構化格式表示數據,因此非常適合處理 CSV 檔案資料。

設定您的項目

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

  1. 開啟 Visual Studio。
  2. 選擇檔案>新建>項目
  3. 選擇一個 C# 控制台應用程式或 Windows 窗體應用程序,並為其命名。

步驟 2:安裝IronXL

IronXL是一個功能強大的庫,可讓您在 C# 中處理 Excel和 CSV 檔案。 要使用它,需要透過NuGet套件管理器進行安裝。 在 Visual Studio 中:

  1. 前往"工具" > "NuGet套件管理員" > "管理解決方案的NuGet套件"
  2. 搜尋IronXL

    如何在 C# 中將 CSV 檔案匯入資料表:圖 1 - IronXL

  3. 將軟體包安裝到您的專案中。

使用IronXL將 CSV 檔案讀取到 DataTables 中

步驟 1:設定環境

using IronXL;
using System.Data;
using IronXL;
using System.Data;
$vbLabelText   $csharpLabel

這些using語句包含了我們任務所需的命名空間。

步驟 2:建立匯入 CSV 檔案的方法

定義一個類別CsvToDataTable ,並定義一個靜態方法ImportCsvToDataTable 。 此方法負責將 CSV 檔案轉換為DataTable

public class CsvToDataTable
{
    public static DataTable ImportCsvToDataTable(string filePath)
    {
        // Code snippet to import CSV will be placed here
        return null; // Placeholder return statement
    }
}
public class CsvToDataTable
{
    public static DataTable ImportCsvToDataTable(string filePath)
    {
        // Code snippet to import CSV will be placed here
        return null; // Placeholder return statement
    }
}
$vbLabelText   $csharpLabel

步驟 3:載入 CSV 文件

ImportCsvToDataTable方法中,首先載入 CSV 檔案。 IronXL 提供了一種簡單直接的方法來實現這IronXL:

// Load the CSV file
WorkBook workbook = WorkBook.LoadCSV(filePath);
// Load the CSV file
WorkBook workbook = WorkBook.LoadCSV(filePath);
$vbLabelText   $csharpLabel

WorkBook.LoadCSV是IronXL中用來載入 CSV 檔案的方法。 其中, filePath是您的 CSV 檔案的路徑。

步驟 4:將 CSV 檔案轉換為資料表

將載入的 CSV 資料轉換為DataTable 。 這一步驟至關重要,因為它將資料轉換為可以在 C# 應用程式中輕鬆操作和顯示的格式。

// Get the first worksheet
WorkSheet sheet = workbook.DefaultWorkSheet;
// Convert CSV worksheet to DataTable
DataTable dataTable = sheet.ToDataTable();
return dataTable;
// Get the first worksheet
WorkSheet sheet = workbook.DefaultWorkSheet;
// Convert CSV worksheet to DataTable
DataTable dataTable = sheet.ToDataTable();
return dataTable;
$vbLabelText   $csharpLabel

這段程式碼將 CSV 資料轉換為DataTableDefaultWorkSheet方法會從工作簿中取得第一個工作表,如果是 CSV 文件,IronXL一個強大功能,它可以有效率地將 CSV 資料對應到DataTable結構,如果 CSV 檔案的第一行包含列標題行,也會將其包含在內。

步驟 5:在應用程式中使用該方法

現在,在您的應用程式中使用ImportCsvToDataTable方法。 例如,您可能希望在應用程式啟動時或使用者上傳 CSV 檔案時呼叫此方法。

// Usage
string csvFilePath = "csvfile.csv";
DataTable dataTable = CsvToDataTable.ImportCsvToDataTable(csvFilePath);
// Usage
string csvFilePath = "csvfile.csv";
DataTable dataTable = CsvToDataTable.ImportCsvToDataTable(csvFilePath);
$vbLabelText   $csharpLabel

此程式碼片段示範如何呼叫ImportCsvToDataTable方法。 將"csvfile.csv"替換為您的 CSV 檔案的實際檔案路徑。

步驟 6:處理輸出資料表

有了資料表之後,就可以執行各種操作,例如在使用者介面中顯示資料、篩選資料或處理資料。 以下是一些例子:

在控制台應用程式中顯示數據

foreach (DataRow row in dataTable.Rows)
{
    foreach (var item in row.ItemArray)
    {
        Console.Write($"{item} ");
    }
    Console.WriteLine();
}
foreach (DataRow row in dataTable.Rows)
{
    foreach (var item in row.ItemArray)
    {
        Console.Write($"{item} ");
    }
    Console.WriteLine();
}
$vbLabelText   $csharpLabel

這段程式碼遍歷資料表中的每一行和每一列,並將資料列印到控制台。

資料篩選

您可以使用 LINQ 來篩選 DataTable 中的資料。 例如,如果您想要選擇特定列符合某個條件的行:

var filteredRows = dataTable.AsEnumerable()
                            .Where(row => row.Field<string>("ColumnName") == "SomeValue");
var filteredRows = dataTable.AsEnumerable()
                            .Where(row => row.Field<string>("ColumnName") == "SomeValue");
$vbLabelText   $csharpLabel

"ColumnName""SomeValue"替換為要篩選的列名和值。

完整程式碼片段

以下是完整的源代碼,您可以在專案中使用:

using IronXL;
using System;
using System.Data;
using System.IO;

public class CsvToDataTable
{
    public static DataTable ImportCsvToDataTable(string filePath)
    {
        // Check if the file exists
        if (!File.Exists(filePath))
        {
            throw new FileNotFoundException($"The file at {filePath} was not found.");
        }

        // Load the CSV file
        WorkBook workbook = WorkBook.LoadCSV(filePath);
        // Get the first worksheet
        WorkSheet sheet = workbook.DefaultWorkSheet;
        // Convert the worksheet to DataTable
        DataTable dataTable = sheet.ToDataTable();
        return dataTable;
    }
}

class Program
{
    static void Main(string[] args)
    {
        // Usage
        try
        {
            string filePath = "sample_data.csv"; // CSV file path
            DataTable dataTable = CsvToDataTable.ImportCsvToDataTable(filePath);
            foreach (DataRow row in dataTable.Rows)
            {
                foreach (var item in row.ItemArray)
                {
                    Console.Write($"{item} ");
                }
                Console.WriteLine();
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"An error occurred: {ex.Message}");
        }
    }
}
using IronXL;
using System;
using System.Data;
using System.IO;

public class CsvToDataTable
{
    public static DataTable ImportCsvToDataTable(string filePath)
    {
        // Check if the file exists
        if (!File.Exists(filePath))
        {
            throw new FileNotFoundException($"The file at {filePath} was not found.");
        }

        // Load the CSV file
        WorkBook workbook = WorkBook.LoadCSV(filePath);
        // Get the first worksheet
        WorkSheet sheet = workbook.DefaultWorkSheet;
        // Convert the worksheet to DataTable
        DataTable dataTable = sheet.ToDataTable();
        return dataTable;
    }
}

class Program
{
    static void Main(string[] args)
    {
        // Usage
        try
        {
            string filePath = "sample_data.csv"; // CSV file path
            DataTable dataTable = CsvToDataTable.ImportCsvToDataTable(filePath);
            foreach (DataRow row in dataTable.Rows)
            {
                foreach (var item in row.ItemArray)
                {
                    Console.Write($"{item} ");
                }
                Console.WriteLine();
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"An error occurred: {ex.Message}");
        }
    }
}
$vbLabelText   $csharpLabel

您可以在 Program.cs 檔案中使用此程式碼。如果您在生產環境中使用,請不要忘記新增IronXL的授權。

程式碼輸出

運行程式碼後,它將載入 CSV 檔案並將其資料匯入到資料表中。 之後,控制台將顯示資料表列的內容。 這有助於驗證資料是否已正確匯入到資料表中。

如何在 C# 中將 CSV 檔案匯入資料表:圖 2 - 輸出

應對不同情況

在實際應用中,CSV 檔案的格式和結構可能存在很大差異。 妥善處理這些變化至關重要,以確保應用程式的穩健性和通用性。接下來,我們將詳細介紹在使用IronXL將 CSV 資料匯入 DataTable 時如何處理不同的場景。

處理不同的分隔符

逗號是 CSV 檔案中的預設分隔符號。 但是,CSV 檔案可能並非總是使用逗號分隔值。 有時,會使用分號、製表符或其他字元作為分隔符號。 在IronXL中處理此問題:

指定自訂分隔符號:在載入 CSV 檔案之前,您可以指定檔案的分隔符號。 例如,如果你的檔案使用分號( ; ),你可以這樣設定:

WorkBook workbook = WorkBook.LoadCSV(filePath, listDelimiter: ";");
WorkBook workbook = WorkBook.LoadCSV(filePath, listDelimiter: ";");
$vbLabelText   $csharpLabel

處理大型 CSV 文件

處理大型 CSV 檔案時,必須考慮記憶體使用情況和效能。 IronXL提供了一種高效的方式來處理大型文件,而無需一次性將整個文件加載到記憶體中。 您可以分塊讀取文件,也可以利用IronXL提供的串流 API 來有效管理記憶體使用量。

結論

使用IronXL在 C# 中將 CSV 資料匯入 DataTable 非常簡單。 它增強了應用程式的資料處理能力,使您能夠有效率地處理 CSV 檔案。 透過本教程中概述的步驟,初學者可以輕鬆地將此功能整合到他們的 C# 專案中。

IronXL提供免費試用,供用戶體驗其各項功能。 對於尋求更高級功能和支援的用戶,我們提供許可選項。

常見問題解答

如何在 C# 中將 CSV 數據導入 DataTable?

您可以使用 IronXL 的 WorkBook.LoadCSV 方法加載 CSV 文件,然後使用 ToDataTable 方法將其轉換為 DataTable。

設置使用 IronXL 的 Visual Studio 項目需要哪些步驟?

要設置使用 IronXL 的 Visual Studio 項目,請通過導航到工具 > NuGet 包管理器 > 為解決方案管理 NuGet 包來安裝 IronXL 包,然後搜索 IronXL.Excel 並將其添加到您的項目中。

IronXL 能處理帶有不同分隔符的 CSV 文件嗎?

是的,IronXL 可以通過在 WorkBook.LoadCSV 方法中使用 listDelimiter 參數指定自定義分隔符來處理帶有不同分隔符的 CSV 文件。

加載 CSV 文件時遇到"找不到文件"錯誤時應該怎麼辦?

如果遇到"找不到文件"錯誤,請確保文件路徑正確。使用 File.Exists(filePath) 檢查文件是否存在以防止此類錯誤。

如何在 C# 中高效管理大型 CSV 文件?

為了高效管理大型 CSV 文件,IronXL 提供了以塊讀取文件或使用流 API 的功能,有助於優化內存使用和性能。

CSV 數據轉換為 DataTable 有什麼好處?

將 CSV 數據轉換為 DataTable 能夠進行結構化數據操作,使其更容易在 C# 應用程序中處理、篩選和顯示數據。

如何在 C# 控制台應用程序中顯示 DataTable 內容?

要在 C# 控制台應用程序中顯示 DataTable 內容,請迭代遍歷每個 DataRow 並使用嵌套循環打印每個項目以在控制台顯示數據。

CSV 文件是什麼,為什麼它有用?

CSV 文件,或逗號分隔值文件,是一種用逗號分隔數據的純文本文件。由於其簡單性和與許多應用程序的兼容性,它被廣泛用於數據交換。

導入 CSV 到 DataTable 教程需要哪些前提條件?

要遵循教程,您需要對 C# 有基本的了解,在您的計算機上安裝了 Visual Studio,以及可以通過 NuGet 包管理器獲得的 IronXL 庫。

Jordi Bardia
軟體工程師
Jordi 在 Python、C# 和 C++ 上最得心應手,當他不在 Iron Software 展現技術時,便在做遊戲編程。在分担產品测测试,產品開發和研究的责任時,Jordi 為持续的產品改進增值。他说这种多样化的经验使他受到挑战并保持参与, 而这也是他与 Iron Software 中工作一大乐趣。Jordi 在佛罗里达州迈阿密长大,曾在佛罗里达大学学习计算机科学和统计学。

鋼鐵支援團隊

我們每週 5 天,每天 24 小時在線上。
聊天
電子郵件
打電話給我