C# CSV 庫：使用 IronXL 的完整教學

如何設定 C# 電子表格庫？

透過NuGet安裝IronXL只需不到一分鐘。 在 Visual Studio 中開啟程式包管理器控制台並執行以下命令，或從任何終端使用.NET CLI：

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

安裝軟體包後，將命名空間新增至任何需要處理電子表格資料的檔案：

using IronXL;

using IronXL;

IronXL 的目標框架為.NET Framework 4.6.2+和所有現代.NET版本(Core、5、6、7、8、9 和 10)。 它可在 Windows、Linux 和 macOS 上運行，因此既適用於桌面工具，也適用於容器化伺服器工作負載。 請造訪IronXL安裝指南，以取得軟體套件來源和授權啟用的逐步說明。

如何在C#中讀取CSV檔？

使用IronXL讀取 CSV 檔案與載入任何電子表格遵循相同的模式。 呼叫 WorkBook.Load 並傳入檔案路徑， IronXL會根據檔案副檔名推斷檔案格式—無需額外配置：

// Load a CSV file into a WorkBook
WorkBook workBook = WorkBook.Load("sales_data.csv");

// Access the default worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Read individual cells by Excel-style address
string customerName = workSheet["A2"].StringValue;
decimal orderAmount = workSheet["B2"].DecimalValue;

// Iterate rows, starting at index 1 to skip the header
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    Console.WriteLine($"Customer: {row.Columns[0].Value}, Amount: {row.Columns[1].Value}");
}

// Load a CSV file into a WorkBook
WorkBook workBook = WorkBook.Load("sales_data.csv");

// Access the default worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Read individual cells by Excel-style address
string customerName = workSheet["A2"].StringValue;
decimal orderAmount = workSheet["B2"].DecimalValue;

// Iterate rows, starting at index 1 to skip the header
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    Console.WriteLine($"Customer: {row.Columns[0].Value}, Amount: {row.Columns[1].Value}");
}

WorkBook 物件公開了完整的電子表格模型。 您可以使用熟悉的 Excel 表示法(例如 "A2")來存取單元格，內建的轉換屬性 -- DateTimeValue@@ -- 字串。

// Access a range and print each value
foreach (var cell in workSheet["A2:C10"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Value}");
}

// Access a range and print each value
foreach (var cell in workSheet["A2:C10"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Value}");
}

public record SalesRecord(string Customer, decimal Amount, DateTime OrderDate);

WorkBook workBook = WorkBook.Load("sales_data.csv");
WorkSheet workSheet = workBook.DefaultWorkSheet;

var records = new List<SalesRecord>();

// Start at row 1 to skip the header row (row 0)
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    records.Add(new SalesRecord(
        Customer: row.Columns[0].StringValue,
        Amount: row.Columns[1].DecimalValue,
        OrderDate: row.Columns[2].DateTimeValue
    ));
}

public record SalesRecord(string Customer, decimal Amount, DateTime OrderDate);

WorkBook workBook = WorkBook.Load("sales_data.csv");
WorkSheet workSheet = workBook.DefaultWorkSheet;

var records = new List<SalesRecord>();

// Start at row 1 to skip the header row (row 0)
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    records.Add(new SalesRecord(
        Customer: row.Columns[0].StringValue,
        Amount: row.Columns[1].DecimalValue,
        OrderDate: row.Columns[2].DateTimeValue
    ));
}

如何在C#中寫入CSV檔案？

從頭開始建立 CSV 檔案涉及三個步驟：建立 WorkBook，填入 WorkSheet，然後呼叫 SaveAsCsv。 該過程與建立任何電子表格的方式類似，從而保證了 AP 的一致性，而與輸出格式無關：

// Create a new workbook and worksheet
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("inventory");

// Write header row
workSheet["A1"].Value = "Product";
workSheet["B1"].Value = "Quantity";
workSheet["C1"].Value = "Price";

// Write data rows
workSheet["A2"].Value = "Widget A";
workSheet["B2"].Value = 250;
workSheet["C2"].Value = 9.99;

workSheet["A3"].Value = "Gadget B";
workSheet["B3"].Value = 120;
workSheet["C3"].Value = 24.50;

// Export to CSV
workBook.SaveAsCsv("inventory.csv");

// Create a new workbook and worksheet
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("inventory");

// Write header row
workSheet["A1"].Value = "Product";
workSheet["B1"].Value = "Quantity";
workSheet["C1"].Value = "Price";

// Write data rows
workSheet["A2"].Value = "Widget A";
workSheet["B2"].Value = 250;
workSheet["C2"].Value = 9.99;

workSheet["A3"].Value = "Gadget B";
workSheet["B3"].Value = 120;
workSheet["C3"].Value = 24.50;

// Export to CSV
workBook.SaveAsCsv("inventory.csv");

SaveAsCsv 處理分隔符號放置、包含逗號的欄位的引用以及換行符號規範化。 您無需手動管理任何這些事項。 IronXL在匯出過程中保留數值類型，以便 Excel 或 pandas 等下游工具將數字讀取為數字，而不是讀取為引號的文字字串。

DataTable dataTable = GetProductsFromDatabase();

WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("products");

workSheet.InsertDataTable(dataTable, "A1");

workBook.SaveAsCsv("products.csv");

DataTable dataTable = GetProductsFromDatabase();

WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("products");

workSheet.InsertDataTable(dataTable, "A1");

workBook.SaveAsCsv("products.csv");

如何在C#中實現CSV和Excel之間的轉換？

IronXL最有價值的功能之一是 CSV 和 Excel 格式之間的雙向轉換。 此 API 是對稱的 -- Load 可以讀取任何受支援的格式，而 Save 系列方法可以將資料寫入目標格式：

// Convert CSV to Excel
WorkBook csvWorkBook = WorkBook.Load("data.csv");
csvWorkBook.SaveAs("data.xlsx");

// Convert Excel back to CSV
WorkBook xlsxWorkBook = WorkBook.Load("report.xlsx");
xlsxWorkBook.SaveAsCsv("report.csv");

// Convert CSV to Excel
WorkBook csvWorkBook = WorkBook.Load("data.csv");
csvWorkBook.SaveAs("data.xlsx");

// Convert Excel back to CSV
WorkBook xlsxWorkBook = WorkBook.Load("report.xlsx");
xlsxWorkBook.SaveAsCsv("report.csv");

這些轉換操作可以保持資料的完整性。 數值保持數值形式，日期欄位保持其類型，公式結果在寫入之前會計算出其計算值。 當您將多工作表 Excel 檔案轉換為 CSV 時， IronXL會自動為每個工作表建立單獨的 CSV 檔案：

WorkBook multiSheetWorkBook = WorkBook.Load("quarterly_report.xlsx");

// Produces: quarterly_report.Sheet1.csv, quarterly_report.Sheet2.csv, etc.
multiSheetWorkBook.SaveAsCsv("quarterly_report.csv");

WorkBook multiSheetWorkBook = WorkBook.Load("quarterly_report.xlsx");

// Produces: quarterly_report.Sheet1.csv, quarterly_report.Sheet2.csv, etc.
multiSheetWorkBook.SaveAsCsv("quarterly_report.csv");

這種行為對於下游使用者期望每個文件對應一個主題的報告管道尤其有用。 CSV寫入教學課程還介紹了其他選項，例如指定分隔符號以及控制匯出中包含哪些工作表。

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

第一步：

免費啟動

為什麼僅支援 CSV 格式的函式庫無法滿足實際專案的需求？

許多 C# 開發人員從 Microsoft.VisualBasic 中的CsvHelper或文字欄位解析器開始。 兩者都是適用於僅處理 CSV 檔案的工作流程的有效工具。 當需求擴大時，差距就會顯現：利害關係人要求下載 Excel 文件而不是 CSV 文件，財務部門需要保留公式，或安全策略要求對文件進行密碼保護。 這時，僅支援 CSV 的函式庫會迫使你新增第二個依賴項並維護兩個獨立的整合路徑。 統一的電子表格庫從一開始就消除了這種分裂。

下一步計劃是什麼？

IronXL為您提供一個統一的 API，用於在任何.NET 10 應用程式中讀取、寫入和轉換 CSV 和 Excel 檔案。 主要優勢顯而易見：不依賴 Office，支援跨平台，單元格值支援強類型，並且當需求發生變化時，可以直接從僅支援 CSV 的專案過渡到完整的電子表格功能。

當你準備好深入研究時，從與你目前專案最相關的主題開始。 如果您主要處理 CSV 匯入管道，那麼上面介紹的讀取和映射模式可以處理大多數實際場景。 如果您的輸出要求有所不同——有時是下游腳本所需的 CSV 文件，有時是最終用戶所需的 XLSX 文件——格式轉換部分展示瞭如何使用單一程式碼庫來同時滿足這兩種需求。

對於建立報告系統或從資料庫匯出結果的團隊來說，InsertDataTable 方法具有良好的可擴展性，並且避免了逐行單元格分配帶來的效能開銷。 結合儲存格樣式，即可產生使用者無需重新格式化即可在 Excel 中直接開啟的報表。

若要繼續進行，請按照以下步驟操作：

1. 使用NuGet安裝庫Install-Package IronXL 或 dotnet add package IronXL。 2.按照IronXL入門指南中的快速入門步驟載入您的第一個 CSV 檔案。
2. 當您需要在同一個專案中同時使用 CSV 和 Excel 格式時，請探索 CSV 到 Excel 格式轉換教學。
3. 查看IronXL物件參考中的API 參考，以了解進階儲存格操作、公式支援和樣式設定。
4. 在IronXL試用許可證頁面開始免費試用－無需信用卡，包含技術支援。

如果您正在評估其他Iron Software工具的選項， IronSoftware 產品套件涵蓋了使用IronPDF生成 PDF、條碼讀取、OCR 等功能——所有這些都共享相同的許可模式和支援管道。