已更新 2026年6月28日
using Microsoft Office Interop Excel C# 读取 Excel 文件：以及一种无需 Office 即可更快创建 Excel 文件的方法
using Microsoft Office Interop Excel 在 C# 中读取 Excel 文件，然后切换到 IronXL 以创建服务器安全、跨平台的 Excel 文件，而无需依赖 Office。
阅读更多
USING IRONXL
如何在 C# 中导入、读取及操作 Excel 数据
Curtis Chau
Updated: 2026年6月28日
StreamReader无法读取Excel文件，因为XLSX/XLS格式是复杂的二进制或压缩XML结构，而不是纯文本。 请改用IronXL库，它提供WorkBook.Load()进行文件读取，并通过FromStream()处理内存流，无需依赖Excel Interop。
许多C#开发人员在尝试读取Excel表文件时遇到一个常见问题：他们所依赖的StreamReader，在处理文本文件时完美运行，但面对Excel文档时却莫名失败。 如果您曾尝试使用C#的StreamReader读取Excel文件但看到乱码或异常，不要担心，您并不孤单。 本教程解释了为何StreamReader无法直接处理Excel文件，并演示了在无需Excel Interop的情况下使用IronXL的正确解决方案。
常常有人会因为CSV文件，Excel可以打开，而与StreamReader一起正常运行而感到困惑。 然而，真正的 Excel 文件（XLSX、XLS）需要采用完全不同的方法。 理解这一区别将为您节省数小时的调试时间，并引导您找到完成这项工作的正确工具。 对于在Docker容器或Kubernetes环境中部署应用程序的DevOps工程师来说，这一点尤为关键，因为本机依赖项会使容器化复杂化。
为什么StreamReader不能读取Excel文件？
StreamReader专为纯文本文件设计，通过指定的编码逐行读取字符数据。 尽管Excel文件看似电子表格，其实是复杂的二进制或ZIP压缩XML结构，StreamReader无法解释。 现代的 XLSX 文件遵循 Office Open XML 标准，而较旧的 XLS 文件则采用专有二进制格式。
static void Main(string[] args)
{
// This code will NOT work - demonstrates the problem
using (StreamReader reader = new StreamReader("ProductData.xlsx"))
{
string content = reader.ReadLine(); // Attempts to read Excel as text
Console.WriteLine(content); // Outputs garbled binary data
}
}Sub Main(ByVal args As String())
' This code will NOT work - demonstrates the problem
Using reader As New StreamReader("ProductData.xlsx")
Dim content As String = reader.ReadLine() ' Attempts to read Excel as text
Console.WriteLine(content) ' Outputs garbled binary data
End Using
End Sub当您运行这段代码时，看到的不是电子表格数据，而是二进制数据，例如"PK♥♦"或类似字符。 这是因为 XLSX 文件是包含多个 XML 文件的 ZIP 压缩文件，而 XLS 文件使用专有的二进制格式。 StreamReader期望纯文本，并试图将这些复杂结构解释为字符，导致无意义的输出。 对于容器化应用程序，若尝试使用原生 Excel 库或 COM 互操作，则需要在容器中安装 Microsoft Office，这将大幅增加镜像大小并增加复杂性。
StreamReader尝试处理Excel文件时会发生什么？
以下示例展示了一个典型的 Excel 文件，其中包含我们要处理的产品数据。 请注意，当在 Excel 中查看时，结构化的电子表格数据显得整洁有序：
为什么输出结果显示乱码？
当StreamReader尝试处理此Excel文件时，控制台输出显示了潜在的问题。 您看到的不是可读数据，而是二进制内容，因为文件结构无法被解释为文本：
现代 Excel 文件 (XLSX) 包含多个组件：工作表、样式、共享字符串和关系，所有这些都打包在一起。 这种复杂性需要能够理解 Excel 文件结构的专用库，这便引出了 IronXL。 该库在内部处理所有这些复杂操作的同时，提供了一个简单的 API，使其非常适合无法进行人工干预的自动化部署管道。
如何使用 IronXL 读取 Excel 文件？
IronXL 为在 C# 中读取 Excel 文件提供了一个简便的解决方案。 与StreamReader不同，IronXL理解Excel的内部结构，并提供直观的方法来访问您的数据。 该库支持 Windows、Linux、macOS 以及 Docker 容器，非常适合现代跨平台应用程序。 对于DevOps团队来说，IronXL的零依赖架构意味着在部署过程中无需管理本机库或COM组件。
首先，通过 NuGet 包管理器安装 IronXL：
以下是正确读取 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}");
}Imports IronXL
' Load the Excel file
Dim workbook As WorkBook = WorkBook.Load("sample.xlsx")
Dim worksheet As WorkSheet = workbook.DefaultWorkSheet
' Read specific cell values
Dim cellValue As String = worksheet("A1").StringValue
Console.WriteLine($"Cell A1 contains: {cellValue}")
' Read a range of cells
For Each cell In worksheet("A1:C5")
Console.WriteLine($"{cell.AddressString}: {cell.Text}")
Next此代码成功加载了您的 Excel 文件，并提供了对单元格值的便捷访问。 WorkBook.Load 方法会自动检测文件格式（XLSX、XLS、XLSM、CSV），并在内部处理所有复杂的解析工作。 您可以使用"A1"等熟悉的 Excel 标记或"A1:C5"等单元格范围来访问单元格，这使得代码对任何熟悉 Excel 的人来说都直观易懂。
对于容器化部署，您可以轻松集成健康检查端点，以验证 Excel 处理能力：
// Health check endpoint for containerized apps
public async Task<IActionResult> HealthCheck()
{
try
{
// Test Excel functionality
using var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
var sheet = workbook.CreateWorkSheet("HealthCheck");
sheet["A1"].Value = DateTime.UtcNow;
// Convert to byte array for validation
var bytes = workbook.ToByteArray();
return Ok(new {
status = "healthy",
excelSupport = true,
timestamp = DateTime.UtcNow
});
}
catch (Exception ex)
{
return StatusCode(503, new {
status = "unhealthy",
error = ex.Message
});
}
}' Health check endpoint for containerized apps
Public Async Function HealthCheck() As Task(Of IActionResult)
Try
' Test Excel functionality
Using workbook = WorkBook.Create(ExcelFileFormat.XLSX)
Dim sheet = workbook.CreateWorkSheet("HealthCheck")
sheet("A1").Value = DateTime.UtcNow
' Convert to byte array for validation
Dim bytes = workbook.ToByteArray()
Return Ok(New With {
.status = "healthy",
.excelSupport = True,
.timestamp = DateTime.UtcNow
})
End Using
Catch ex As Exception
Return StatusCode(503, New With {
.status = "unhealthy",
.error = ex.Message
})
End Try
End Function如何从内存流中读取Excel？
实际应用中经常需要处理来自数据流而不是磁盘文件的 Excel 文件。 常见应用场景包括处理网页上传、从数据库检索文件，或处理来自 AWS S3 或 Azure Blob Storage 等云存储的数据。 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 DataTable
var dataTable = worksheet.ToDataTable(false);
// Display DataTable row count
Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");
}Imports IronXL
Imports System.IO
' Read Excel from a memory stream
Dim fileBytes As Byte() = File.ReadAllBytes("ProductData.xlsx")
Using stream As New MemoryStream(fileBytes)
Dim workbook As WorkBook = WorkBook.FromStream(stream)
Dim worksheet As WorkSheet = workbook.DefaultWorkSheet
' Process the data
Dim rowCount As Integer = worksheet.RowCount
Console.WriteLine($"The worksheet has {rowCount} rows")
' Read all data into a DataTable
Dim dataTable = worksheet.ToDataTable(False)
' Display DataTable row count
Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows")
End UsingFileStream还是网络流。 这种灵活性使您能够处理来自各种来源的 Excel 文件，而无需先将其保存到磁盘。该示例还演示了如何将工作表数据转换为 DataTable，该 DataTable 可与数据库和数据绑定场景无缝集成。 对于微服务架构，这种基于流的方法可最大限度地减少磁盘 I/O，从而提升性能。
内存流处理会产生什么结果？
在 Excel 读取场景中，何时应使用对象发送者？
在事件驱动编程中使用此代码的情况下（例如，在Windows Forms或ASP.NET中处理文件上传按钮），方法签名常常包含诸如对象sender和EventArgs e之类的参数。 此上下文可确保 Excel 处理逻辑与 UI 或服务事件正确关联。 对于容器化 API，您可以直接处理来自 HTTP 请求的上传：
[HttpPost("upload")]
public async Task<IActionResult> ProcessExcelUpload(IFormFile file)
{
if (file == null || file.Length == 0)
return BadRequest("No file uploaded");
using var stream = new MemoryStream();
await file.CopyToAsync(stream);
stream.Position = 0;
var workbook = WorkBook.FromStream(stream);
var worksheet = workbook.DefaultWorkSheet;
// Process and return results
var data = worksheet.ToDataSet();
return Ok(new {
sheets = workbook.WorkSheets.Count,
rows = worksheet.RowCount,
processed = DateTime.UtcNow
});
}<HttpPost("upload")>
Public Async Function ProcessExcelUpload(file As IFormFile) As Task(Of IActionResult)
If file Is Nothing OrElse file.Length = 0 Then
Return BadRequest("No file uploaded")
End If
Using stream As New MemoryStream()
Await file.CopyToAsync(stream)
stream.Position = 0
Dim workbook = WorkBook.FromStream(stream)
Dim worksheet = workbook.DefaultWorkSheet
' Process and return results
Dim data = worksheet.ToDataSet()
Return Ok(New With {
.sheets = workbook.WorkSheets.Count,
.rows = worksheet.RowCount,
.processed = DateTime.UtcNow
})
End Using
End Function
如何在Excel和CSV之间进行转换？
虽然StreamReader可以处理CSV文件，但您通常需要在Excel和CSV格式之间进行转换。 IronXL使这种转换变得简单，这在DevOps工作流中常见的ETL流水线和数据集成场景中特别有用：
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");Imports IronXL
' Load an Excel file and save as CSV
Dim workbook As WorkBook = WorkBook.Load("data.xlsx")
workbook.SaveAsCsv("output.csv")
' Load a CSV file and save as Excel
Dim csvWorkbook As WorkBook = WorkBook.LoadCSV("input.csv")
csvWorkbook.SaveAs("output.xlsx")
' Export specific worksheet to CSV
Dim worksheet As WorkSheet = workbook.WorkSheets(0)
worksheet.SaveAsCsv("worksheet1.csv")这些转换操作会在更改文件格式的同时保留您的数据。 在将 Excel 转换为 CSV 时，IronXL 默认会将第一个工作表转换为平面数据，但您可以指定要导出的工作表。 将 CSV 转换为 Excel 可生成格式规范的电子表格，既能保留数据类型，也便于后续进行格式调整和公式添加。
对于自动化数据管道，您还可以导出为 JSON 或 XML 格式：
// Export Excel to multiple formats for data pipelines
var workbook = WorkBook.Load("report.xlsx");
// Export to JSON for API responses
string jsonData = workbook.ToJson();
// Export to HTML for web display
workbook.SaveAsHtml("report.html");
// Export to XML for integration systems
workbook.SaveAsXml("report.xml");
// Export specific range to DataTable for database insertion
var dataTable = workbook.DefaultWorkSheet["A1:D10"].ToDataTable();' Export Excel to multiple formats for data pipelines
Dim workbook = WorkBook.Load("report.xlsx")
' Export to JSON for API responses
Dim jsonData As String = workbook.ToJson()
' Export to HTML for web display
workbook.SaveAsHtml("report.html")
' Export to XML for integration systems
workbook.SaveAsXml("report.xml")
' Export specific range to DataTable for database insertion
Dim dataTable = workbook.DefaultWorkSheet("A1:D10").ToDataTable()容器部署最佳实践
对于部署Excel处理应用程序的DevOps工程师，IronXL提供了多种优势。 以下是一个针对 Excel 处理进行优化的、可直接投入生产的 Dockerfile：
FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443
# Install any required system fonts for Excel rendering
RUN apt-get update && apt-get install -y \
fontconfig \
libfreetype6 \
&& rm -rf /var/lib/apt/lists/*
FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src
COPY ["YourApp.csproj", "."]
RUN dotnet restore
COPY . .
RUN dotnet build -c Release -o /app/build
FROM build AS publish
RUN dotnet publish -c Release -o /app/publish
FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
# Set environment variables for IronXL
ENV IRONXL_LICENSE_KEY=${IRONXL_LICENSE_KEY}
ENV DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=false
ENTRYPOINT ["dotnet", "YourApp.dll"]Text
此 Dockerfile 可确保您的 Excel 处理应用程序在容器中顺畅运行，且依赖项极少。 许可管理通过环境变量实现，便于在不同部署环境中进行管理。
Excel处理在C#中的下一步是什么？
StreamReader无法处理Excel文件的原因源于纯文本与Excel复杂文件结构之间的根本区别。 虽然StreamReader对CSV和其他文本格式工作得很好，但真正的Excel文件需要像IronXL这样的专用库来理解其中的二进制和XML结构。
IronXL 凭借其直观的 API、广泛的格式支持以及无缝的流处理能力，提供了一套全面的解决方案。 无论您是在开发 Web 应用程序、桌面软件还是云服务，IronXL 都能在所有平台上可靠地处理 Excel 文件。 该库支持条件格式、图表、公式以及 Excel 的高级功能，使其成为 Enterprise 应用程序的完整解决方案。
对于DevOps团队来说，IronXL的容器友好架构、最小的系统依赖性和稳固的性能特性使其成为现代云原生应用程序的理想选择。 该库支持水平扩展，可在 Kubernetes Pod 中无缝运行，并与 CI/CD 管道完美集成。
准备好开始正确使用Excel文件了吗？ 下载最适合您项目需求的 IronXL 免费试用版。 该库提供灵活的许可选项，涵盖开发、预发布和生产环境部署，并支持容器化环境及云原生应用程序。
技术作家
Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。
...
阅读更多相关文章
已更新 2026年7月19日
在.NET C# 中下载 Excel 文件：将数据导出为 XLSX、CSV 等格式
using C# 和IronXL在ASP.NET Core中下载 Excel 文件。从 MVC 控制器导出数据到 XLSX、CSV 和 XML 格式，并返回 MemoryStream 和 File() 函数。包含代码示例。
阅读更多
已更新 2026年6月28日
如何在不使用互操作的情况下，使用 C# 在 Excel 中创建数据透视表
学习如何使用 C# 在 Excel 中创建数据透视表，无需依赖 Office 套件。本指南涵盖 Excel Interop 和IronXL ，并提供完整的代码示例。
阅读更多
您需要的 Excel API，无需 Office Interop 烦恼。
