C# 中讀取 Excel 檔案的 StreamReader 替代方案 - IronXL

為什麼 StreamReader 無法讀取 Excel 檔案？

StreamReader 專為純文字檔案設計，使用指定的編碼逐行讀取字元資料。 Excel 檔案雖然看起來像電子表格，但實際上是複雜的二進位或 ZIP 壓縮的 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
    }
}

當您執行此類程式碼片段時，您將不會看到電子表格數據，而是會遇到二進位未知數據，例如"PK♥♦"或類似的系統字元。 這是因為 XLSX 檔案是包含多個 XML 檔案的 ZIP 壓縮文件，而 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}");
}

這段程式碼可以成功載入您的 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");
}

WorkBook.FromStream 方法接受任何流類型，無論是 FileStream 或網路流。 這種靈活性使您無需先將 Excel 檔案儲存到磁碟即可處理來自各種來源的檔案。此範例還示範如何將工作表資料轉換為 DataTable，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");

這些轉換操作會在變更檔案格式的同時保留您的資料。 將 Excel 轉換為 CSV 時， IronXL預設會將第一個工作表展平，但您可以指定要匯出的工作表。 將 CSV 檔案轉換為 Excel 檔案會產生格式正確的電子表格，該電子表格可以保留資料類型，並支援將來進行格式設定和新增公式。

結論

StreamReader 無法處理 Excel 檔案的原因在於純文字與 Excel 複雜的檔案結構之間存在根本差異。 雖然 StreamReader 可以完美地處理 CSV 和其他文字格式，但真正的 Excel 檔案需要像IronXL這樣的專門庫來理解其中的二進位和 XML 結構。

IronXL憑藉其直覺的 API、全面的格式支援和無縫的串流處理功能，提供了一個優雅的解決方案。 無論您是建立 Web 應用程式、桌面軟體或雲端服務， IronXL都能在所有平台上可靠地處理 Excel 檔案。

準備好開始正確使用Excel檔案了嗎？ 下載 IronXL 的免費試用版，體驗在 C# 應用程式中輕鬆處理 Excel 資料。 對於生產環境部署，請考慮最適合您專案需求的IronXL授權選項。