如何在 C# 中導入、讀取和操作 Excel 數據

為什麼 StreamReader 無法讀取 Excel 文件？

StreamReader 專為純文本文件設計，使用指定的編碼按行讀取字符數據。 Excel 文件儘管像是電子表格，但實際上是複雜的二進制或壓縮 XML 結構，StreamReader 無法解析。

static void Main(string[] args)
{
 // This code will NOT work - demonstrates the problem
 using (StreamReader reader = new StreamReader("ProductData.xlsx"))
 {
    string content = reader.ReadLine(); // read data
    Console.WriteLine(content); // Outputs garbled binary data
 }
}

static void Main(string[] args)
{
 // This code will NOT work - demonstrates the problem
 using (StreamReader reader = new StreamReader("ProductData.xlsx"))
 {
    string content = reader.ReadLine(); // read data
    Console.WriteLine(content); // Outputs garbled binary data
 }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

當您運行這段程序代碼時，您會看到二進制數據，如 "PK♥♦" 或類似的系統字符，而不是您的表格數據。 這是因為 XLSX 文件是包含多個 XML 文件的壓縮文件，而 XLS 文件使用專有的二進制格式。 StreamReader 期望純文本並試圖將這些複雜結構解釋為字符，導致無意義的輸出。

如何使用 IronXL 讀取 Excel 文件？

IronXL 提供了一種在 C# 中讀取 Excel 文件的簡單解決方案。 與 StreamReader 不同，IronXL 理解 Excel 的內部結構，並提供直觀的方法來訪問您的數據。 該庫支持 Windows、Linux、macOS 和 Docker 容器，非常適合現代跨平台應用。

首先，通過 NuGet 包管理器安裝 IronXL：

Install-Package IronXL.Excel

以下是正確讀取 Excel 文件的方法：

using IronXL;
// Load the Excel file
WorkBook workbook = WorkBook.Load("sample.xlsx");
WorkSheet worksheet = workbook.DefaultWorkSheet;
// Read specific cell values
string cellValue = worksheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");
// Read a range of cells
foreach (var cell in worksheet["A1:C5"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}

using IronXL;
// Load the Excel file
WorkBook workbook = WorkBook.Load("sample.xlsx");
WorkSheet worksheet = workbook.DefaultWorkSheet;
// Read specific cell values
string cellValue = worksheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");
// Read a range of cells
foreach (var cell in worksheet["A1:C5"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

此代碼成功加載您的 Excel 文件，並提供對單元格值的乾淨訪問。 WorkBook.Load 方法自動檢測文件格式（XLSX、XLS、XLSM、CSV），並在內部處理所有複雜解析。 您可以使用熟悉的 Excel 符號比如 "A1" 或範圍如 "A1:C5" 來訪問單元格，使代碼對任何熟悉 Excel 的人都直觀易懂。

如何從內存流中讀取 Excel？

在實際應用中，常常需要從流而非磁盤文件處理 Excel 文件。 常見場景包括處理網絡上傳、從數據庫檢索文件或處理來自雲存儲的數據。 IronXL 優雅地處理了這些情況：

using IronXL;
using System.IO;
// Read Excel from a memory stream
byte[] fileBytes = File.ReadAllBytes("ProductData.xlsx");
using (MemoryStream stream = new MemoryStream(fileBytes))
{
    WorkBook workbook = WorkBook.FromStream(stream);
    WorkSheet worksheet = workbook.DefaultWorkSheet;
    // Process the data
    int rowCount = worksheet.RowCount;
    Console.WriteLine($"The worksheet has {rowCount} rows");
    // Read all data into a new DataTable, return dt
    var dataTable = worksheet.ToDataTable(false);
    // Return DataTable row count 
    Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");
}

using IronXL;
using System.IO;
// Read Excel from a memory stream
byte[] fileBytes = File.ReadAllBytes("ProductData.xlsx");
using (MemoryStream stream = new MemoryStream(fileBytes))
{
    WorkBook workbook = WorkBook.FromStream(stream);
    WorkSheet worksheet = workbook.DefaultWorkSheet;
    // Process the data
    int rowCount = worksheet.RowCount;
    Console.WriteLine($"The worksheet has {rowCount} rows");
    // Read all data into a new DataTable, return dt
    var dataTable = worksheet.ToDataTable(false);
    // Return DataTable row count 
    Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

WorkBook.FromStream 方法接受任何類型的流，無論是 MemoryStream、FileStream 還是網絡流。 這種靈活性允許您在不先保存到磁盤的情況下從各種來源處理 Excel 文件。該示例還演示了將工作表數據轉換為 DataTable，這與數據庫和數據綁定場景無縫集成。

如何在 Excel 和 CSV 之間轉換？

雖然 StreamReader 可以處理 CSV 文件，但您常常需要在 Excel 和 CSV 格式之間進行轉換。 IronXL 使這種轉換變得簡單：

using IronXL;
// Load an Excel file and save as CSV
WorkBook workbook = WorkBook.Load("data.xlsx");
workbook.SaveAsCsv("output.csv");
// Load a CSV file and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("input.csv");
csvWorkbook.SaveAs("output.xlsx");
// Export specific worksheet to CSV
WorkSheet worksheet = workbook.WorkSheets[0];
worksheet.SaveAsCsv("worksheet1.csv");

using IronXL;
// Load an Excel file and save as CSV
WorkBook workbook = WorkBook.Load("data.xlsx");
workbook.SaveAsCsv("output.csv");
// Load a CSV file and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("input.csv");
csvWorkbook.SaveAs("output.xlsx");
// Export specific worksheet to CSV
WorkSheet worksheet = workbook.WorkSheets[0];
worksheet.SaveAsCsv("worksheet1.csv");

IRON VB CONVERTER ERROR developers@ironsoftware.com

這些轉換會在改變文件格式的同時保留您的數據。 在將 Excel 轉換為 CSV 時，IronXL 會默認展開第一個工作表，但您可以指定導出的工作表。 從 CSV 轉換到 Excel 則會創建出正確格式的電子表格，保留數據類型，並啟用將來的格式和公式添加。

結論

StreamReader 無法處理 Excel 文件的原因由於純文本與 Excel 複雜文件結構之間的基本區別所致。 雖然 StreamReader 對 CSV 和其他文本格式完全有效，但真正的 Excel 文件需要像 IronXL 這樣能夠理解內部二進制和 XML 結構的專門庫。

IronXL 通過其直觀的 API、全面的格式支持和流暢的流處理功能提供了一個優雅的解決方案。 無論您是在構建 Web 應用、桌面軟件還是雲服務，IronXL 都能在所有平台上可靠地處理 Excel 文件。

準備好正確地開始處理 Excel 文件了嗎？ 下載 IronXL 的免費試用版，最適合您的項目需求。