如何在C#中而不是使用StreamReader來讀取Excel文件

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

StreamReader 是一個基於文字的閱讀器。 它使用指定的編碼（UTF-8、ASCII 等）逐行讀取字元數據，並且不了解二進位結構或壓縮存檔。 官方的.NET StreamReader 文件證實，這類專為字元編碼文字而設計。 Excel 檔案雖然看起來像是簡單的電子表格，但實際上是複雜的二進位或 ZIP 壓縮的 XML 結構，StreamReader 無法解釋。

當您使用 StreamReader 開啟 XLSX 檔案時，您實際上是在嘗試將 ZIP 壓縮檔案作為純文字讀取。 結果得到的不是電子表格數據，而是一串二進位雜訊。

// This code will NOT work -- demonstrates the problem
using StreamReader reader = new StreamReader("ProductData.xlsx");
string content = reader.ReadLine();
Console.WriteLine(content); // Outputs garbled binary data like "PK♥♦"

// This code will NOT work -- demonstrates the problem
using StreamReader reader = new StreamReader("ProductData.xlsx");
string content = reader.ReadLine();
Console.WriteLine(content); // Outputs garbled binary data like "PK♥♦"

運行此程式碼片段後，您看到的不是電子表格行，而是諸如 PK♥♦ 之類的二進位字元或類似亂碼。這是因為：

• XLSX 檔案是包含多個 XML 檔案的 ZIP 壓縮套件：工作表、樣式、共用字串、關係式。 Open XML SDK 文件提供了該結構的詳細說明。
• XLS 檔案使用專有的二進位格式(BIFF——二進位交換檔案格式)
• StreamReader 會對讀取的所有位元組應用字元編碼，導致兩種格式的輸出都毫無意義。

如何在.NET專案中安裝IronXL ？

IronXL是一個.NET函式庫，無需安裝 Microsoft Excel 即可讀取、寫入和建立 Excel 檔案。 它支援 XLSX、XLS、XLSM、CSV 和 TSV 格式，並且可以在 Windows、Linux、macOS 和 Docker 容器上運行。

要安裝IronXL，可以使用NuGet套件管理器控制台或.NET CLI。 該軟體包已發佈在NuGet上，名為IronXL ：

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

安裝完成後，將 using IronXL; 指令新增至您的檔案中，即可開始處理 Excel 文件。

如需詳細的安裝步驟和NuGet設定選項，請參閱IronXL NuGet安裝指南。 我們提供免費試用許可證，您可以在購買前在您的專案中評估IronXL 的效果。

如何使用IronXL讀取 Excel 檔案？

IronXL提供了一個直覺的 API，用於在 C# 中讀取 Excel 檔案。 與 StreamReader 不同， IronXL了解 Excel 的內部結構，並為您提供對行、列和儲存格值的清晰存取。 IronXL文件提供了所有受支援操作的完整 API 參考。

以下是如何使用IronXL和頂級語句讀取 Excel 檔案：

using IronXL;

// Load the Excel file from disk
WorkBook workbook = WorkBook.Load("ProductData.xlsx");
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Read a specific cell by address
string cellValue = worksheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");

// Iterate over a range of cells
foreach (var cell in worksheet["A1:C10"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}

// Read a numeric value
decimal price = worksheet["B2"].DecimalValue;
Console.WriteLine($"Price: {price:C}");

using IronXL;

// Load the Excel file from disk
WorkBook workbook = WorkBook.Load("ProductData.xlsx");
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Read a specific cell by address
string cellValue = worksheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");

// Iterate over a range of cells
foreach (var cell in worksheet["A1:C10"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}

// Read a numeric value
decimal price = worksheet["B2"].DecimalValue;
Console.WriteLine($"Price: {price:C}");

WorkBook.Load 方法會自動偵測檔案格式(XLSX、XLS、XLSM、CSV)，並處理所有複雜的解析。 您可以使用標準的 Excel 表示法(例如 "A1")或範圍(例如 "A1:C10")來存取儲存格，這使得任何熟悉電子表格的人都能立即閱讀程式碼。

using IronXL;

WorkBook workbook = WorkBook.Load("MultiSheet.xlsx");

// List all worksheets
foreach (WorkSheet sheet in workbook.WorkSheets)
{
    Console.WriteLine($"Sheet: {sheet.Name}, Rows: {sheet.RowCount}");
}

// Access a sheet by name
WorkSheet summary = workbook.GetWorkSheet("Summary");
string totalRevenue = summary["B20"].StringValue;
Console.WriteLine($"Total Revenue: {totalRevenue}");

// Access a sheet by index
WorkSheet firstSheet = workbook.WorkSheets[0];
int lastRow = firstSheet.RowCount;
Console.WriteLine($"Last row in first sheet: {lastRow}");

using IronXL;

WorkBook workbook = WorkBook.Load("MultiSheet.xlsx");

// List all worksheets
foreach (WorkSheet sheet in workbook.WorkSheets)
{
    Console.WriteLine($"Sheet: {sheet.Name}, Rows: {sheet.RowCount}");
}

// Access a sheet by name
WorkSheet summary = workbook.GetWorkSheet("Summary");
string totalRevenue = summary["B20"].StringValue;
Console.WriteLine($"Total Revenue: {totalRevenue}");

// Access a sheet by index
WorkSheet firstSheet = workbook.WorkSheets[0];
int lastRow = firstSheet.RowCount;
Console.WriteLine($"Last row in first sheet: {lastRow}");

如何從記憶體流讀取Excel資料？

實際應用中經常需要處理來自資料流而不是磁碟檔案的 Excel 檔案。 常見情境包括處理從 Web 表單上傳的檔案、從資料庫 BLOB 欄位擷取工作簿，或處理從雲端儲存(Azure Blob Storage、AWS S3)下載的檔案。 IronXL透過 WorkBook.FromStream 處理這些情況：

using IronXL;
using System.IO;

// Simulate reading file bytes (e.g., from a database or web upload)
byte[] fileBytes = File.ReadAllBytes("ProductData.xlsx");

using MemoryStream stream = new MemoryStream(fileBytes);
WorkBook workbook = WorkBook.FromStream(stream);
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Get row and column counts
Console.WriteLine($"Rows: {worksheet.RowCount}, Columns: {worksheet.ColumnCount}");

// Convert to DataTable for database or grid binding
var dataTable = worksheet.ToDataTable(useHeaderRow: true);
Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");

foreach (System.Data.DataRow row in dataTable.Rows)
{
    string productName = row["ProductName"]?.ToString() ?? string.Empty;
    string sku = row["SKU"]?.ToString() ?? string.Empty;
    Console.WriteLine($"Product: {productName}, SKU: {sku}");
}

using IronXL;
using System.IO;

// Simulate reading file bytes (e.g., from a database or web upload)
byte[] fileBytes = File.ReadAllBytes("ProductData.xlsx");

using MemoryStream stream = new MemoryStream(fileBytes);
WorkBook workbook = WorkBook.FromStream(stream);
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Get row and column counts
Console.WriteLine($"Rows: {worksheet.RowCount}, Columns: {worksheet.ColumnCount}");

// Convert to DataTable for database or grid binding
var dataTable = worksheet.ToDataTable(useHeaderRow: true);
Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");

foreach (System.Data.DataRow row in dataTable.Rows)
{
    string productName = row["ProductName"]?.ToString() ?? string.Empty;
    string sku = row["SKU"]?.ToString() ?? string.Empty;
    Console.WriteLine($"Product: {productName}, SKU: {sku}");
}

WorkBook.FromStream 接受任何 Stream -- FileStream 或網路流。 這種靈活性意味著您無需為了讀取 Excel 資料而將臨時檔案寫入磁碟。 轉換為 DataTable 也可以直接與 SqlBulkCopy、資料綁定控制項和報錶框架整合。

如何在Excel和CSV格式之間進行轉換？

雖然 StreamReader 可以處理 CSV 文件，但生產應用通常需要在 Excel 和 CSV 之間傳輸資料。 IronXL讓格式轉換變得簡單易行。 只需幾行程式碼，即可將 Excel 資料匯出為 CSV 文件，或將 CSV 資料匯入工作簿中：

using IronXL;

// Load an Excel file and save as CSV
WorkBook workbook = WorkBook.Load("SalesData.xlsx");
workbook.SaveAsCsv("output.csv");

// Load a CSV file and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("legacy-report.csv");
csvWorkbook.SaveAs("converted.xlsx");

// Export a specific worksheet to CSV
WorkSheet worksheet = workbook.WorkSheets[0];
worksheet.SaveAsCsv("sheet1-export.csv");

using IronXL;

// Load an Excel file and save as CSV
WorkBook workbook = WorkBook.Load("SalesData.xlsx");
workbook.SaveAsCsv("output.csv");

// Load a CSV file and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("legacy-report.csv");
csvWorkbook.SaveAs("converted.xlsx");

// Export a specific worksheet to CSV
WorkSheet worksheet = workbook.WorkSheets[0];
worksheet.SaveAsCsv("sheet1-export.csv");

這些轉換操作會在變更容器格式的同時保留您的資料。 將 Excel 轉換為 CSV 時， IronXL預設會匯出第一個工作表； 您可以指定任何您選擇的圖紙。 將 CSV 檔案轉換為 Excel 檔案會建立一個結構正確的 Excel 工作簿，您可以對其進行格式化、新增公式並寫入其他資料。

如何使用IronXL建立和格式化 Excel 檔案？

讀取Excel資料只是工作流程的一部分。 許多應用程式還需要建立新的 Excel 檔案並套用格式。 IronXL支援儲存格格式設置，包括字型、顏色、邊框、數字格式和儲存格合併：

using IronXL;

// Create a new workbook and worksheet
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("Report");

// Write headers with formatting
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Units Sold";
sheet["C1"].Value = "Revenue";

// Apply bold formatting to header row
sheet["A1:C1"].Style.Font.Bold = true;
sheet["A1:C1"].Style.SetBackgroundColor("#4472C4");
sheet["A1:C1"].Style.Font.Color = "#FFFFFF";

// Write data rows
string[] products = { "Widget A", "Widget B", "Widget C" };
int[] units = { 120, 85, 210 };
decimal[] revenues = { 2400.00m, 1700.00m, 4200.00m };

for (int i = 0; i < products.Length; i++)
{
    sheet[$"A{i + 2}"].Value = products[i];
    sheet[$"B{i + 2}"].Value = units[i];
    sheet[$"C{i + 2}"].Value = revenues[i];
    sheet[$"C{i + 2}"].FormatString = "$#,##0.00";
}

// Save the workbook
workbook.SaveAs("FormattedReport.xlsx");
Console.WriteLine("Report created successfully.");

using IronXL;

// Create a new workbook and worksheet
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("Report");

// Write headers with formatting
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Units Sold";
sheet["C1"].Value = "Revenue";

// Apply bold formatting to header row
sheet["A1:C1"].Style.Font.Bold = true;
sheet["A1:C1"].Style.SetBackgroundColor("#4472C4");
sheet["A1:C1"].Style.Font.Color = "#FFFFFF";

// Write data rows
string[] products = { "Widget A", "Widget B", "Widget C" };
int[] units = { 120, 85, 210 };
decimal[] revenues = { 2400.00m, 1700.00m, 4200.00m };

for (int i = 0; i < products.Length; i++)
{
    sheet[$"A{i + 2}"].Value = products[i];
    sheet[$"B{i + 2}"].Value = units[i];
    sheet[$"C{i + 2}"].Value = revenues[i];
    sheet[$"C{i + 2}"].FormatString = "$#,##0.00";
}

// Save the workbook
workbook.SaveAs("FormattedReport.xlsx");
Console.WriteLine("Report created successfully.");

IronXL既能讀取現有工作簿，又能建立新的格式化文件，使其成為適用於.NET應用程式的完整 Excel 解決方案。 請查看IronXL 的完整功能頁面，以了解支援的操作的詳細資訊。

如何在生產環境中獲得IronXL 的許可並進行部署？

IronXL可免費用於開發和測試。 生產應用需要許可證。 您可以造訪產品頁面以了解IronXL 的授權選項，根據您的部署需求，這些選項涵蓋開發人員、團隊和組織層級。

購買後，請在呼叫任何IronXL函數之前，在程式碼中套用您的許可證密鑰：

IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

或者，在部署環境中設定 IRONXL_LICENSE_KEY 環境變量， IronXL將自動識別它。 對於容器化部署（Docker、Kubernetes）和雲端環境，這是首選方法，因為在這些環境中，硬編碼金鑰是不可接受的。

為了方便評估，免費試用許可證提供完整功能，以便您在購買前驗證IronXL是否適用於您的特定工作負載。 無需信用卡即可試用，試用期立即生效。

與 Microsoft.Office.Interop.Excel 等替代方案相比， IronXL具有以下幾個部署優勢：

• 伺服器上無需安裝 Microsoft Excel
• 相容於 Linux 和 Docker——這對雲端原生應用至關重要
• 沒有 COM 物件生命週期管理或單元執行緒問題
• 伺服器環境下啟動速度更快，記憶體佔用更低
• 在所有支援的平台上表現一致

IronXL具備這些特性，對於任何需要在生產環境中處理 Excel 檔案的.NET應用程式來說，無論是在本地還是在雲端，它都是一個實用的選擇。