如何使用 IronXL 在 C# 中快速讀取 CSV 檔案？

如何使用IronXL在 C# 中快速讀取 CSV 檔案？

使用IronXL （一個.NET庫）在 C# 中快速讀取 CSV 檔案非常簡單，只需幾行程式碼即可將逗號分隔的資料轉換為可查詢的工作簿。 呼叫 WorkBook.LoadCSV，存取您的工作表，並開始遍歷行——無需 StreamReader 樣板程式碼、無需手動拆分邏輯，也無需安裝 Office。

如何安裝IronXL以開始使用？

在加載任何 CSV 資料之前，請透過NuGet將IronXL新增至您的專案。 開啟專案目錄中的套件管理器控制台或終端，然後執行下列命令之一：

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

安裝完成後，在要讀取或寫入 CSV 資料的任何檔案的頂部新增 using IronXL;。 IronXL面向.NET 10 及所有現代.NET版本，因此無需額外的運行時配置。 該軟體包包含所有必需的元件——無需單獨的本地二進位檔案、平台 SDK 或設定檔。 您可以透過檢查專案檔案中的 <PackageReference Include="IronXL" .../> 條目來驗證安裝是否成功。

若要快速了解該程式庫除了處理 CSV 檔案之外還能做什麼，請參閱IronXL功能頁面和NuGet套件清單。

如何在 C# 中載入和讀取 CSV 檔案？

讀取 CSV 資料的最快途徑是從 WorkBook.LoadCSV 方法開始。 一次呼叫即可處理檔案載入、解析每一行，並傳回一個功能齊全的工作簿對象，可供資料存取－這與手動建立 StreamReader 並自行處理每一行截然不同。

using IronXL;

// Load CSV file directly into a workbook
WorkBook workbook = WorkBook.LoadCSV("sales_data.csv", file格式: ExcelFile格式.XLSX);

// Access the default worksheet containing CSV data
WorkSheet sheet = workbook.DefaultWorkSheet;

// Read specific cell values using Excel-style addressing
string customerName = sheet["A2"].StringValue;
decimal orderTotal = sheet["D2"].DecimalValue;

// Iterate through all data rows
foreach (var row in sheet.Rows)
{
    Console.WriteLine($"Row {row.RowNumber}: {row.Columns[0].Value}");
}

using IronXL;

// Load CSV file directly into a workbook
WorkBook workbook = WorkBook.LoadCSV("sales_data.csv", file格式: ExcelFile格式.XLSX);

// Access the default worksheet containing CSV data
WorkSheet sheet = workbook.DefaultWorkSheet;

// Read specific cell values using Excel-style addressing
string customerName = sheet["A2"].StringValue;
decimal orderTotal = sheet["D2"].DecimalValue;

// Iterate through all data rows
foreach (var row in sheet.Rows)
{
    Console.WriteLine($"Row {row.RowNumber}: {row.Columns[0].Value}");
}

LoadCSV 方法接受檔案名稱和可選的格式規範，自動偵測逗號分隔符號並將每個欄位值解析到對應的儲存格中。 解析器預設將第一行視為標題數據，從而可以直接透過名稱存取列名。

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

現實世界中的 CSV 檔案很少遵循單一標準。 歐洲系統通常使用分號作為分隔符號(因為逗號用作小數分隔符號)，而製表符分隔值 (TSV) 檔案在科學和傳統應用程式中很常見。 IronXL透過 listDelimiter 參數處理這些變化，支援任何字元或字串作為分隔符號。

using IronXL;

// Load semicolon-delimited CSV (common in European formats)
WorkBook europeanData = WorkBook.LoadCSV("german_report.csv",
    file格式: ExcelFile格式.XLSX,
    listDelimiter: ";");

// Load tab-separated values file
WorkBook tsvData = WorkBook.LoadCSV("research_data.tsv",
    file格式: ExcelFile格式.XLSX,
    listDelimiter: "\t");

// Load pipe-delimited file (common in legacy systems)
WorkBook pipeData = WorkBook.LoadCSV("legacy_export.csv",
    file格式: ExcelFile格式.XLSX,
    listDelimiter: "|");

// Access data identically regardless of original delimiter
WorkSheet sheet = europeanData.DefaultWorkSheet;
Console.WriteLine($"First value: {sheet["A1"].Value}");

using IronXL;

// Load semicolon-delimited CSV (common in European formats)
WorkBook europeanData = WorkBook.LoadCSV("german_report.csv",
    file格式: ExcelFile格式.XLSX,
    listDelimiter: ";");

// Load tab-separated values file
WorkBook tsvData = WorkBook.LoadCSV("research_data.tsv",
    file格式: ExcelFile格式.XLSX,
    listDelimiter: "\t");

// Load pipe-delimited file (common in legacy systems)
WorkBook pipeData = WorkBook.LoadCSV("legacy_export.csv",
    file格式: ExcelFile格式.XLSX,
    listDelimiter: "|");

// Access data identically regardless of original delimiter
WorkSheet sheet = europeanData.DefaultWorkSheet;
Console.WriteLine($"First value: {sheet["A1"].Value}");

listDelimiter 參數接受任何字串值，幾乎可以靈活地使用任何分隔符號或序列。 資料載入完成後，無論原始檔案格式為何，都可以透過相同的 API 存取數據，從而在各種資料來源中創造一致的開發體驗。

如何將CSV資料轉換為DataTable？

資料庫操作經常需要 DataTable 格式的 CSV 數據，以便進行批次插入、LINQ 查詢或綁定到資料感知控制項。 ToDataTable 方法只需一次呼叫即可將工作表資料直接轉換為 System.Data.DataTable 對象，無需手動建立清單或陣列結構。

using IronXL;
using System.Data;

// Load CSV and convert to DataTable
WorkBook workbook = WorkBook.LoadCSV("customers.csv", ExcelFile格式.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// Convert worksheet to DataTable (first row becomes column headers)
DataTable customerTable = sheet.ToDataTable(true);

// Access data using standard DataTable operations
foreach (DataRow row in customerTable.Rows)
{
    Console.WriteLine($"Customer: {row["Name"]}, Email: {row["Email"]}");
}

// Use with LINQ for filtering and transformation
var activeCustomers = customerTable.AsEnumerable()
    .Where(r => r.Field<string>("Status") == "Active")
    .ToList();

int totalCount = customerTable.Rows.Count;
Console.WriteLine($"Processed {totalCount} customer records");

using IronXL;
using System.Data;

// Load CSV and convert to DataTable
WorkBook workbook = WorkBook.LoadCSV("customers.csv", ExcelFile格式.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// Convert worksheet to DataTable (first row becomes column headers)
DataTable customerTable = sheet.ToDataTable(true);

// Access data using standard DataTable operations
foreach (DataRow row in customerTable.Rows)
{
    Console.WriteLine($"Customer: {row["Name"]}, Email: {row["Email"]}");
}

// Use with LINQ for filtering and transformation
var activeCustomers = customerTable.AsEnumerable()
    .Where(r => r.Field<string>("Status") == "Active")
    .ToList();

int totalCount = customerTable.Rows.Count;
Console.WriteLine($"Processed {totalCount} customer records");

ToDataTable 方法會自動將工作表列對應到 DataTable 列。 當 useFirstRowAsColumnHeaders 設定為 true 時，第一行的值將變為列名，因此可以透過名稱而不是索引存取欄位。 DataTable 可直接與 SqlBulkCopy 集成，實現高性能 SQL Server 插入；或者，它可以綁定到 DataGridView 控件，以便立即進行可視化。

轉換過程中會盡可能保留資料類型， IronXL會根據底層儲存格值推斷數值、日期和文字類型。 這種自動類型推斷減少了處理原始 CSV 字串時通常需要的手動解析。 熟悉的 DataTable API 意味著處理資料庫查詢結果的現有程式碼無需修改即可處理 CSV 資料——這在遷移專案中可以節省大量時間。

如何將CSV檔案轉換為Excel格式？

IronXL 的主要功能之一是 CSV 和 Excel 檔案之間的格式轉換。 CSV 資料可以透過格式設定、公式和多個工作表進行增強，然後儲存為適當的 Excel 工作簿——所有這些都可以在同一個程式碼庫中完成。 若要深入了解單元格樣式選項和公式編輯，請參閱IronXL文檔，其中詳細介紹了每個功能。

using IronXL;

// Load CSV data
WorkBook workbook = WorkBook.LoadCSV("quarterly_sales.csv", ExcelFile格式.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// Add formatting to make the data presentable
sheet["A1:D1"].Style.Font.Bold = true;
sheet["A1:D1"].Style.SetBackgroundColor("#4472C4");

// Add a formula to calculate totals
sheet["E2"].Formula = "=SUM(B2:D2)";

// Save as Excel format
workbook.SaveAs("quarterly_sales_formatted.xlsx");

// Or save back to CSV when needed
workbook.SaveAsCsv("quarterly_sales_processed.csv");

using IronXL;

// Load CSV data
WorkBook workbook = WorkBook.LoadCSV("quarterly_sales.csv", ExcelFile格式.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// Add formatting to make the data presentable
sheet["A1:D1"].Style.Font.Bold = true;
sheet["A1:D1"].Style.SetBackgroundColor("#4472C4");

// Add a formula to calculate totals
sheet["E2"].Formula = "=SUM(B2:D2)";

// Save as Excel format
workbook.SaveAs("quarterly_sales_formatted.xlsx");

// Or save back to CSV when needed
workbook.SaveAsCsv("quarterly_sales_processed.csv");

SaveAs 方法根據檔案副檔名決定輸出格式，支援 XLSX、XLS、CSV、TSV、JSON 和 XML 匯出。 這種靈活性意味著單一匯入過程可以為多個輸出管道提供資料——例如，為管理層產生 Excel 報告，為下游系統產生 CSV 提取文件。 背景和圖案顏色指南展示了所有可用的樣式選項。

如何高效處理大型 CSV 檔案？

處理包含數十萬行資料的 CSV 檔案需要周密的記憶體管理。 IronXL提供處理大型資料集的實用方法，同時保持簡單易用的 API。 建議採用分批處理資料的方式，而不是同時載入和轉換每個記錄，這樣可以控制活動記憶體的使用情況。

using IronXL;

// Load large CSV file
WorkBook workbook = WorkBook.LoadCSV("large_dataset.csv", ExcelFile格式.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// Process data in manageable chunks using range selection
int batchSize = 10000;
int totalRows = sheet.RowCount;

for (int i = 1; i <= totalRows; i += batchSize)
{
    int endRow = Math.Min(i + batchSize - 1, totalRows);

    // Select a range of rows for processing
    var batch = sheet[$"A{i}:Z{endRow}"];
    foreach (var cell in batch)
    {
        ProcessRecord(cell.Value);
    }

    // Release memory between batches for very large files
    GC.Collect();
}

// Alternative: Process row by row for maximum control
for (int i = 0; i < sheet.RowCount; i++)
{
    var row = sheet.Rows[i];
    // Process individual row data
}

using IronXL;

// Load large CSV file
WorkBook workbook = WorkBook.LoadCSV("large_dataset.csv", ExcelFile格式.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// Process data in manageable chunks using range selection
int batchSize = 10000;
int totalRows = sheet.RowCount;

for (int i = 1; i <= totalRows; i += batchSize)
{
    int endRow = Math.Min(i + batchSize - 1, totalRows);

    // Select a range of rows for processing
    var batch = sheet[$"A{i}:Z{endRow}"];
    foreach (var cell in batch)
    {
        ProcessRecord(cell.Value);
    }

    // Release memory between batches for very large files
    GC.Collect();
}

// Alternative: Process row by row for maximum control
for (int i = 0; i < sheet.RowCount; i++)
{
    var row = sheet.Rows[i];
    // Process individual row data
}

這種批次處理模式允許系統地處理大型文件，而無需嘗試同時處理每個記錄。 範圍選擇語法($"A{i}:Z{endRow}")可有效存取特定行範圍。

如何跨平台運行 CSV 處理？

現代.NET開發跨越多個部署環境－Windows 伺服器、Linux 容器、macOS 開發機器和雲端平台。 IronXL在所有這些環境中都能穩定運行，無需特定於平台的程式碼路徑或條件編譯。

using IronXL;

// This code runs identically on Windows, Linux, macOS, Docker, Azure, and AWS
WorkBook workbook = WorkBook.LoadCSV("data.csv", ExcelFile格式.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// 平台-agnostic file operations
string outputPath = Path.Combine(Environment.CurrentDirectory, "output.xlsx");
workbook.SaveAs(outputPath);

Console.WriteLine($"Processed on: {Environment.OSVersion.平台}");
Console.WriteLine($"Output saved to: {outputPath}");

bool success = File.Exists(outputPath);

using IronXL;

// This code runs identically on Windows, Linux, macOS, Docker, Azure, and AWS
WorkBook workbook = WorkBook.LoadCSV("data.csv", ExcelFile格式.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// 平台-agnostic file operations
string outputPath = Path.Combine(Environment.CurrentDirectory, "output.xlsx");
workbook.SaveAs(outputPath);

Console.WriteLine($"Processed on: {Environment.OSVersion.平台}");
Console.WriteLine($"Output saved to: {outputPath}");

bool success = File.Exists(outputPath);

同一個二進位軟體包可以在不同的作業系統和部署模型上運作。 下表總結了支援的平台：

這種跨平台功能消除了程式碼從開發環境遷移到測試環境再到生產環境時出現的"在我的機器上運作正常"的問題。 在 Windows 工作站上開發的 CSV 處理程序無需修改即可部署到 Linux Docker 容器中。 有關部署配置指南， Microsoft .NET部署文件涵蓋了每個平台的發布策略。

下一步計劃是什麼？

在 C# 中讀取 CSV 檔案不需要為了效能而犧牲程式碼清晰度，也不需要處理複雜的配置。 IronXL提供一致的 API，可自動處理解析、類型轉換和資料訪問，支援從簡單的逗號分隔匯出到歐洲分號分隔格式和製表符分隔的科學資料等各種現實世界的 CSV 變體。

要在生產環境中開始使用IronXL ，請購買IronXL許可證以解鎖所有功能，包括優先支援、一年的更新和免版稅部署。 我們為個人開發者、小型團隊和企業專案提供不同的定價方案。

如果您想在購買前評估IronXL ，免費試用許可證可以讓您在評估期間測試所有功能，而不會出現浮水印或行數限制。 IronXL教程庫提供了涵蓋常見CSV和Excel場景的指導性範例。

對於特定用例（例如處理加密 CSV 檔案、處理非標準編碼或與雲端儲存供應商整合）方面的問題， Iron Software支援團隊和社群論壇可提供協助。 Microsoft Learn提供的其他.NET資料處理資源可提供有關文件輸入/輸出模式的補充信息，這些模式與IronXL配合使用效果更佳。