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

为什么 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应用程序来说，无论是在本地还是在云端，它都是一个实用的选择。