如何在 C# 中將 CSV 文件讀取到 DataTable

為什麼 CSV 到 DataTable 的轉換很重要？

CSV 到 DataTable 轉換允許開發人員將逗號分隔值轉換為結構化物件以進行進一步處理。 無論你處理的是庫存資料、客戶記錄還是交易日誌，有效地將 CSV 轉換為 DataTable 格式都至關重要。 使用第一行作為列標題，可以確保資料表列與資料庫表架構保持一致，使其非常適合Excel 到 SQL 的操作。

傳統方法在處理大型檔案、不同分隔符號或記憶體管理方面常常遇到困難。 IronXL消除了這些挑戰，無需額外程式碼即可處理不同的分隔符號、帶有引號的欄位和嵌入式逗號。 IronXL 的 CSV 讀取功能消除了常見的痛點，同時也提供了資料驗證和檔案大小控制等附加功能。

如何安裝IronXL？

要開始使用IronXL，只需簡單地安裝NuGet套件即可。 在 Visual Studio 中開啟NuGet套件管理器控制台，並執行下列命令之一：

Install-Package IronXL

Install-Package IronXL

或者，如果您喜歡使用.NET命令列介面：

dotnet add package IronXL

dotnet add package IronXL

安裝完成後，將IronXL命名空間新增至您的專案：

using IronXL;
using System.Data;

using IronXL;
using System.Data;

這樣就可以在不依賴 Excel 的情況下存取所有 CSV 處理功能。 更多詳情請參閱IronXL文件和NuGet安裝指南。

如何確認安裝是否成功？

建立一個測試程序，載入 CSV 檔案以驗證安裝情況。 如果您遇到許可訊息，則需要取得許可證密鑰。 檢查項目檔案中的套件引用，確保IronXL顯示正確的版本。 執行基本的 CSV 讀取操作－如果操作完成且沒有錯誤，則表示您的安裝工作正常。

立即開始在您的項目中使用 IronXL 並免費試用。

第一步：

免費啟動

如何將 CSV 檔案轉換為 DataTable？

IronXL的核心工作流程只涉及幾行程式碼。 以下是如何使用 C# 10+ 中的頂級語句讀取 CSV 檔案並將其轉換為 DataTable：

using IronXL;
using System.Data;

// Load CSV file into a WorkBook object
WorkBook workbook = WorkBook.LoadCSV("sales_data.csv",
    fileFormat: ExcelFileFormat.XLSX);

// Access the default worksheet
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Convert to DataTable with headers
DataTable dataTable = worksheet.ToDataTable(true);

// Display the data
foreach (DataRow row in dataTable.Rows)
{
    foreach (var item in row.ItemArray)
    {
        Console.Write($"{item}\t");
    }
    Console.WriteLine();
}

using IronXL;
using System.Data;

// Load CSV file into a WorkBook object
WorkBook workbook = WorkBook.LoadCSV("sales_data.csv",
    fileFormat: ExcelFileFormat.XLSX);

// Access the default worksheet
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Convert to DataTable with headers
DataTable dataTable = worksheet.ToDataTable(true);

// Display the data
foreach (DataRow row in dataTable.Rows)
{
    foreach (var item in row.ItemArray)
    {
        Console.Write($"{item}\t");
    }
    Console.WriteLine();
}

LoadCSV 方法會自動解析您的 CSV 文件，處理引號的欄位和嵌入的逗號。 fileFormat 參數告訴IronXL如何在內部解釋 CSV 數據，確保將其視為 Excel 相容的結構。 載入完成後，ToDataTable(true) 方法將工作表轉換為 DataTable，參數 true 表示應將第一行用作列標題。 這樣就產生了一個乾淨、結構化的 DataTable 文件，其中列名與 CSV 標題相符。 如需了解更多進階操作選項，請查閱完整的IronXL使用指南。

轉換過程也會保留資料類型－數字保持數值形式，日期正確解析，文字欄位保持其格式。 與手動解析方法相比，這種自動類型推斷可以節省大量的開發時間。 對於需要自訂資料格式的情況，可以在轉換之前套用儲存格格式。

如何將 DataTable 匯入 SQL Server？

一旦你擁有了 DataTable，使用 SqlBulkCopy 將其導入 SQL Server 就變得有效率。 以下範例使用 C# 頂級語句：

using System.Data;
using Microsoft.Data.SqlClient;
using IronXL;

// Create connection string
string connectionString = "Data Source=localhost;Initial Catalog=SalesDB;" +
    "Integrated Security=True;TrustServerCertificate=True;";

// Read CSV into DataTable
WorkBook workbook = WorkBook.LoadCSV("inventory_report.csv");
DataTable dataTable = workbook.DefaultWorkSheet.ToDataTable(true);

// Bulk insert into SQL Server
using SqlConnection connection = new SqlConnection(connectionString);
connection.Open();

using SqlBulkCopy bulkCopy = new SqlBulkCopy(connection);

// Set destination table name
bulkCopy.DestinationTableName = "dbo.Inventory";

// Map DataTable columns to SQL table columns
bulkCopy.ColumnMappings.Add("ProductCode", "product_code");
bulkCopy.ColumnMappings.Add("Quantity", "quantity");
bulkCopy.ColumnMappings.Add("LastUpdated", "last_updated");

// Set batch size for better performance
bulkCopy.BatchSize = 1000;

// Write data to SQL Server
bulkCopy.WriteToServer(dataTable);

Console.WriteLine($"Successfully imported {dataTable.Rows.Count} records");

using System.Data;
using Microsoft.Data.SqlClient;
using IronXL;

// Create connection string
string connectionString = "Data Source=localhost;Initial Catalog=SalesDB;" +
    "Integrated Security=True;TrustServerCertificate=True;";

// Read CSV into DataTable
WorkBook workbook = WorkBook.LoadCSV("inventory_report.csv");
DataTable dataTable = workbook.DefaultWorkSheet.ToDataTable(true);

// Bulk insert into SQL Server
using SqlConnection connection = new SqlConnection(connectionString);
connection.Open();

using SqlBulkCopy bulkCopy = new SqlBulkCopy(connection);

// Set destination table name
bulkCopy.DestinationTableName = "dbo.Inventory";

// Map DataTable columns to SQL table columns
bulkCopy.ColumnMappings.Add("ProductCode", "product_code");
bulkCopy.ColumnMappings.Add("Quantity", "quantity");
bulkCopy.ColumnMappings.Add("LastUpdated", "last_updated");

// Set batch size for better performance
bulkCopy.BatchSize = 1000;

// Write data to SQL Server
bulkCopy.WriteToServer(dataTable);

Console.WriteLine($"Successfully imported {dataTable.Rows.Count} records");

SqlBulkCopy 類別為大規模資料導入提供了強大的效能。 ColumnMappings 集合將 DataTable 列對應到具有不同名稱的資料庫列，從而確保您的資料模式具有靈活性。 BatchSize 屬性透過分塊處理記錄而不是一次載入所有內容來優化記憶體使用。 了解更多關於IronXL的導入和匯出功能的資訊。

為了提高資料完整性，請考慮在批次複製操作中實施事務支援。 這樣可以確保在發生錯誤時可以回滾部分導入操作。 您也可以使用 IronXL 的寫入 Excel 檔案功能在匯入前預先驗證資料。

在這裡，您可以使用 SSMS 中的查詢 SELECT * FROM dbo.Inventory; 檢查您的 CSV 資料是否已匯入 SQL Server 中。 首先，請查看範例 CSV 檔案中使用的資料：

現在，如果您查看查詢的輸出，可以看到它已成功將每一列、每一列標題和每一行複製到資料庫表中。

@

如何處理不同的CSV分隔符號？

並非所有 CSV 檔案都使用逗號。 IronXL可處理各種分隔符，使其適用於國際資料格式或傳統系統。 以下範例示範如何載入製表符分隔和分號分隔的檔案：

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

// --- Tab-delimited file ---
string tsvPath = "export_data.tsv";
WorkBook tsvWorkbook = WorkBook.LoadCSV(tsvPath, ExcelFileFormat.XLSX, "\t");

// --- Semicolon-delimited file ---
string semiPath = "european_data.csv";
string tempCsv = Path.Combine(Path.GetTempPath(), "european_data_comma.csv");

// Replace semicolons with commas for proper parsing
string[] lines = File.ReadAllLines(semiPath);
for (int i = 0; i < lines.Length; i++)
{
    lines[i] = lines[i].Replace(';', ',');
}
File.WriteAllLines(tempCsv, lines);

WorkBook semiWorkbook = WorkBook.LoadCSV(tempCsv, ExcelFileFormat.XLSX);

// Print tab-delimited results
DataTable tsvTable = tsvWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("--- Tab-delimited File ---");
foreach (DataColumn col in tsvTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in tsvTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

// Print semicolon-delimited results
DataTable semiTable = semiWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("\n--- Semicolon-delimited File ---");
foreach (DataColumn col in semiTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in semiTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

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

// --- Tab-delimited file ---
string tsvPath = "export_data.tsv";
WorkBook tsvWorkbook = WorkBook.LoadCSV(tsvPath, ExcelFileFormat.XLSX, "\t");

// --- Semicolon-delimited file ---
string semiPath = "european_data.csv";
string tempCsv = Path.Combine(Path.GetTempPath(), "european_data_comma.csv");

// Replace semicolons with commas for proper parsing
string[] lines = File.ReadAllLines(semiPath);
for (int i = 0; i < lines.Length; i++)
{
    lines[i] = lines[i].Replace(';', ',');
}
File.WriteAllLines(tempCsv, lines);

WorkBook semiWorkbook = WorkBook.LoadCSV(tempCsv, ExcelFileFormat.XLSX);

// Print tab-delimited results
DataTable tsvTable = tsvWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("--- Tab-delimited File ---");
foreach (DataColumn col in tsvTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in tsvTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

// Print semicolon-delimited results
DataTable semiTable = semiWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("\n--- Semicolon-delimited File ---");
foreach (DataColumn col in semiTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in semiTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

此程式碼示範如何將具有不同分隔符號的 CSV 檔案載入到IronXL WorkBook 物件中。 以製表符分隔的檔案使用 "\t" 作為分隔符號讀取，而以分號分隔的檔案在載入前會轉換為標準 CSV 格式。 每個工作簿的預設工作表都會轉換為 DataTable，其中 ToDataTable(true)，使用第一行作為列標題。 對於更複雜的文件格式場景，您還可以探索將 Excel 資料匯出為各種格式。

能夠靈活處理不同的分隔符，解決了許多現實世界中的 CSV 解析難題。 在處理歐洲資料格式時，IronXL 的分隔符號處理能夠適應資料格式標準的區域差異。 對於結構不一致的文件，在將其傳遞給 LoadCSV 之前，先對原始文字進行預處理。

RFC 4180 標準定義了IronXL遵循的 CSV 格式規範，用於處理引號的欄位和嵌入的逗號。 Stack Overflow 社群關於在.NET中將 CSV 讀取到 DataTable 的貼文中也詳細討論了這種靈活性。

除了 CSV 格式之外， IronXL還支援哪些功能？

IronXL 的功能遠不止於讀取 CSV 檔案。 該庫在 C# 中處理 Excel 和電子表格操作的全部範圍，使其成為以資料為中心的應用程式的單一依賴項。

下一步是什麼？

IronXL將 CSV 資料庫匯入變成了一個簡單、可靠的過程。 只需幾行程式碼，您就可以：

• 使用LoadCSV 功能從任意檔案路徑讀取 CSV 文件
• 將 CSV 資料轉換為具有正確資料格式的 DataTable
• 透過自動解析保留列標題和資料表列 使用批次操作有效率地將數百萬行資料匯入資料庫表

該程式庫處理了 CSV 解析、記憶體管理和資料類型轉換等複雜細節，讓您可以專注於業務邏輯，而不是檔案處理細節。 無論您是建立ASP.NET應用程式、使用Blazor還是開發.NET 10 桌面應用程序， IronXL都能在所有平台上提供一致、可靠的 CSV 處理。

準備好開始了嗎？ IronXL文件詳細介紹了每個功能，試用許可證可讓您評估整個庫。 憑藉豐富的程式碼範例和清晰的 API 參考，您很快就會在.NET 10 應用程式中有效地處理 CSV 檔案。