信息圖標
跳過到頁腳內容
  1. IronXL
  2. IronXL 部落格
  3. 使用 IronXL
  4. C# 寫入 CSV
使用 IRONXL

如何在 C# 中撰寫 CSV 文件

Jordi Bardia
Jordi Bardia
發表日期:

在 C# 中創建 CSV（逗號分隔值）文件是報告系統、數據交換和集成的核心任務。 然而，許多開發人員對於處理 StreamWriter、轉義字符和格式錯誤感到厭倦。 IronXL 提供了一種更清晰、更快速的方法來使用 c 寫入 CSV 文件，而無需處理分隔符問題或樣板代碼。 在本指南中，您將看到 IronXL 如何簡化 Excel 文件、資料表和自定義數據的 CSV 創建，並提供生產就緒的可靠性。

為什麼傳統的 CSV 寫入無法滿足需求？

使用 StreamWriter 或 StringBuilder 的傳統方法需要手動處理分隔符、特殊字符和編碼問題。 舊方法通常涉及 var writer = new StreamWriter(...) 或 var csv = new StringBuilder()，強迫開發人員編寫大量樣板代碼。 根據 Stack Overflow 討論，開發人員必須編寫大量樣板代碼來管理數據中的逗號、正確地轉義引號並處理換行，同時確保對大型數據集的正確內存管理。 這些手動方法常常在遇到意外字符或編碼不匹配時導致文件損壞。

IronXL 通過提供一個強大的 API 來智能處理 CSV 生成，消除了這些複雜性。 The library manages special characters automatically, supports multiple Excel formats beyond CSV to store data, and requires no Microsoft Excel installation or Interop dependencies.

安裝只需幾秒鐘，只需打開 Visual Studio 並使用 NuGet 包管理器運行以下命令：

Install-Package IronXL.Excel

立即開始免費試用並體驗無障礙的 CSV 生成。

如何將 Excel 文件轉換為 CSV 格式？

創建 CSV 的最簡單方法是轉換現有的 Excel 工作簿。 IronXL 的 WorkBook.Load 方法使這一過程變得非常簡單，只需三行代碼。 我們可以通過創建一個新項目並運行以下測試：

using IronXL;
// Load an existing Excel file (XLSX, XLS, or even CSV)
WorkBook workBook = WorkBook.Load("SalesReport.xlsx");
// Convert and save as CSV - automatically handles the active worksheet
workBook.SaveAsCsv("SalesReport.csv");
using IronXL;
// Load an existing Excel file (XLSX, XLS, or even CSV)
WorkBook workBook = WorkBook.Load("SalesReport.xlsx");
// Convert and save as CSV - automatically handles the active worksheet
workBook.SaveAsCsv("SalesReport.csv");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Load 方法接受多種Excel 格式，包括 XLSX、XLS、XLSM，甚至是現有的 CSV 文件以進行重新格式化。 SaveAsCsv 方法智能地導出活動工作表，同時保留數據類型並無縫處理特殊字符。 在處理多工作表工作簿時，IronXL 自動為每個工作表創建單獨的 CSV 文件，並附加工作表名稱以保持組織性。

如何將文件寫入 CSV：圖 1 - 輸入文件

針對特定工作表控制，開發人員可以針對單個工作表：

// Export a specific worksheet to CSV
WorkSheet worksheet = workBook.WorkSheets[0];
worksheet.SaveAs("Q4_Report.csv");
// Export a specific worksheet to CSV
WorkSheet worksheet = workBook.WorkSheets[0];
worksheet.SaveAs("Q4_Report.csv");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

在處理包含多個數據集的復雜工作簿時，這種有針對性的方法是無價的，允許選擇性導出而不需要手動數據提取。 了解更多有關文檔中的工作表管理的信息。

如何匯出 DataTable 到 CSV?

企業應用程序經常使用來自數據庫或 API 的 DataTable 對象。傳統上，將這些數據寫入 CSV 的過程需要迭代行和列，同時手動構建分隔字符串。 IronXL 簡化了這一常見場景，如 Microsoft 的官方論壇所述：

using IronXL;
using System.Data;
class Program 
{
    // Example method to provide DataTable
    private static DataTable GetCustomerData()
    {
        DataTable table = new DataTable();
        table.Columns.Add("CustomerID", typeof(int));
        table.Columns.Add("Name", typeof(string));
        table.Columns.Add("Email", typeof(string));
        table.Rows.Add(1, "John Doe", "john@example.com");
        table.Rows.Add(2, "Jane Smith", "jane@example.com");
        return table;
    }
    public static void Main()
    {
        // Get your data
        DataTable dataTable = GetCustomerData();
        // Create a new workbook
        WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
        DataSet dataSet = new DataSet();
        dataSet.Tables.Add(dataTable);
        WorkBook.LoadWorkSheetsFromDataSet(dataSet, workBook);
        // Export to CSV
        workBook.SaveAsCsv("CustomerExport.csv");
    }
}
using IronXL;
using System.Data;
class Program 
{
    // Example method to provide DataTable
    private static DataTable GetCustomerData()
    {
        DataTable table = new DataTable();
        table.Columns.Add("CustomerID", typeof(int));
        table.Columns.Add("Name", typeof(string));
        table.Columns.Add("Email", typeof(string));
        table.Rows.Add(1, "John Doe", "john@example.com");
        table.Rows.Add(2, "Jane Smith", "jane@example.com");
        return table;
    }
    public static void Main()
    {
        // Get your data
        DataTable dataTable = GetCustomerData();
        // Create a new workbook
        WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
        DataSet dataSet = new DataSet();
        dataSet.Tables.Add(dataTable);
        WorkBook.LoadWorkSheetsFromDataSet(dataSet, workBook);
        // Export to CSV
        workBook.SaveAsCsv("CustomerExport.csv");
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

此代碼演示了如何在簡單的控制台應用程序中使用 IronXL 將導出為 CSV 文件。 它首先創建一個包含客戶數據的樣本DataTable，並將其添加到 DataSet 中。 而不是手動將值插入工作表，LoadWorkSheetsFromDataSet方法用於根據DataTable自動生成工作簿中的工作表。 一旦所有數據加載到工作簿中，就會使用SaveAsCsv("CustomerExport.csv")將整個工作表導出為 CSV 文件。

輸出

如何寫入 CSV 文件：圖 2 - DataTable 到 CSV 示例的輸出文件

如何從頭開始使用 C# 編寫 CSV 文件？

有時，應用程序需要以編程方式生成新的 CSV 文件，而不依賴於現有數據源。 IronXL 在從頭開始構建電子表格方面非常出色：

using IronXL;
// Create a new workbook
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("Inventory");
// Add headers
workSheet["A1"].Value = "Product ID";
workSheet["B1"].Value = "Product Name";
workSheet["C1"].Value = "Quantity";
workSheet["D1"].Value = "Price";
// Add data rows - supports various data types
workSheet["A2"].Value = 1001;
workSheet["B2"].Value = "Wireless Mouse";
workSheet["C2"].Value = 150;
workSheet["D2"].Value = 29.99;
workSheet["A3"].Value = 1002;
workSheet["B3"].Value = "Mechanical Keyboard";
workSheet["C3"].Value = 75;
workSheet["D3"].Value = 89.99;
// Apply formulas before export
workSheet["E1"].Value = "Total Value";
workSheet["E2"].Formula = "=C2*D2";
// Save as CSV - formulas calculate before export
workBook.SaveAsCsv("Inventory.csv");
using IronXL;
// Create a new workbook
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("Inventory");
// Add headers
workSheet["A1"].Value = "Product ID";
workSheet["B1"].Value = "Product Name";
workSheet["C1"].Value = "Quantity";
workSheet["D1"].Value = "Price";
// Add data rows - supports various data types
workSheet["A2"].Value = 1001;
workSheet["B2"].Value = "Wireless Mouse";
workSheet["C2"].Value = 150;
workSheet["D2"].Value = 29.99;
workSheet["A3"].Value = 1002;
workSheet["B3"].Value = "Mechanical Keyboard";
workSheet["C3"].Value = 75;
workSheet["D3"].Value = 89.99;
// Apply formulas before export
workSheet["E1"].Value = "Total Value";
workSheet["E2"].Formula = "=C2*D2";
// Save as CSV - formulas calculate before export
workBook.SaveAsCsv("Inventory.csv");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

單元格引用系統模仿 Excel 熟悉的 A1 表示法，使代碼對開發人員來說直觀易懂。 IronXL 支持通過範圍為大規模操作設置個別值或範圍。 當出現公式時，庫在導出到 CSV 之前計算結果，以確保數據表示的準確性。 這種程序化的方法可以根據運行時的條件生成動態報告。

輸出

如何寫入 CSV 文件：圖 3 - 從頭開始創建的 CSV 文件

立即開始使用 IronXL。
green arrow pointer

如何解決常見的 CSV 挑戰？

處理分隔符和錯誤處理是 CSV 生成中常見的挑戰。 IronXL 自動處理這些問題，但在需要時提供控制，如開發者論壇所討論：

// Robust error handling
try
{
    WorkBook workBook = WorkBook.Load("Data.xlsx");
    // Specify delimiter options
    workBook.SaveAsCsv("Output.csv", delimiter: ",");
}
catch (Exception ex)
{
    Console.WriteLine($"Export failed: {ex.Message}");
    // Log error or implement retry logic
}
// Robust error handling
try
{
    WorkBook workBook = WorkBook.Load("Data.xlsx");
    // Specify delimiter options
    workBook.SaveAsCsv("Output.csv", delimiter: ",");
}
catch (Exception ex)
{
    Console.WriteLine($"Export failed: {ex.Message}");
    // Log error or implement retry logic
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

IronXL 自動轉義數據字段中的特殊字符，如逗號和引號，無需手動預處理。 該庫對常見問題（如文件訪問問題或無效的數據格式）拋出描述性的異常，以便在生產環境中進行適當的錯誤處理。 通過將代碼包裹在 try-catch 塊中，我們可以輕鬆處理拋出的任何異常。 如需額外的故障排除指南，請查閱全面文檔。

如何寫入 CSV 文件：圖 4 - 成功的 Excel 到 CSV 轉換，同時處理常見挑戰

結論

IronXL 將 C# 的 CSV 寫入從一個手動、容易出錯的過程轉變為一個可靠且精簡的操作。 該庫處理複雜場景，從DataTable導出到特殊字符轉義，這些傳統上需要大量自定義代碼。 無論是轉換現有的 Excel 文件還是從頭構建 CSV 文檔，IronXL 直觀的API都能減少開發時間，同時確保專業的結果。

開發人員可以通過免費試用版探索 IronXL 的全部功能，提供綜合的 CSV 操作功能以及更廣泛的 Excel 功能。 準備好簡化您的 CSV 操作了嗎？ 立即改變您的數據導出過程。

常見問題解答

在 C# 中使用 IronXL 撰寫 CSV 檔案的優勢是什麼？

IronXL 通過消除分隔符處理和樣板代碼的常見問題，提供更簡潔和更快速撰寫 C# CSV 檔案的方法。它簡化了從 Excel 檔案、DataTables 和自定義數據創建 CSV，達到了生產就緒的可靠性。

IronXL 如何處理 CSV 文件中的特殊字符？

IronXL 自動管理特殊字符和轉義序列，確保 CSV 檔案被正確格式化，無需額外編程工作。

IronXL 可以將 Excel 試算表轉換為 CSV 檔案嗎？

是的，IronXL 可以輕鬆將 Excel 試算表轉換為 CSV 檔案，從而實現無縫數據交換和報告功能。

IronXL 能夠將 DataTables 匯出到 CSV 嗎？

IronXL 支持將 DataTables 匯出到 CSV 格式，簡化開發者數據交換和集成的過程。

IronXL 為什麼是一個生產環境下可靠的 CSV 創建選擇？

IronXL 通過簡化 CSV 檔案創建和處理解 CSV 專有挑戰而提供生產就緒的可靠性，確保一致且無錯誤的輸出。

IronXL 的 CSV 檔案創建需要複雜的設置嗎？

不，設置 IronXL 用於 CSV 檔案創建很簡單，允許開發者快速將其功能集成到他們的應用中。

IronXL 如何改善處理 CSV 檔案的開發過程？

IronXL 通過提供強大的解決方案來改善開發過程，減少手寫 CSV 專有邏輯的需要，例如處理分隔符和格式化。

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

相關文章

30 天試用→完整產品。無限制。無需信用卡。 開始免費試用