跳至页脚内容
USING IRONXL

如何在 C# 中导入、读取及操作 Excel 数据

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工程师来说,这一点尤为关键,因为本机依赖项会使容器化复杂化。

IronXL for .NET主页展示了无需Microsoft Office interop读取Excel文件的C#代码示例,涵盖库功能和下载统计信息

为什么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
 }
}
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
$vbLabelText   $csharpLabel

当您运行这段代码时,看到的不是电子表格数据,而是二进制数据,例如"PK♥♦"或类似字符。 这是因为 XLSX 文件是包含多个 XML 文件的 ZIP 压缩文件,而 XLS 文件使用专有的二进制格式。 StreamReader期望纯文本,并试图将这些复杂结构解释为字符,导致无意义的输出。 对于容器化应用程序,若尝试使用原生 Excel 库或 COM 互操作,则需要在容器中安装 Microsoft Office,这将大幅增加镜像大小并增加复杂性。

StreamReader尝试处理Excel文件时会发生什么?

以下示例展示了一个典型的 Excel 文件,其中包含我们要处理的产品数据。 请注意,当在 Excel 中查看时,结构化的电子表格数据显得整洁有序:

Excel电子表格显示了产品数据表,其中包含产品名称(笔记本电脑、鼠标、键盘、显示器、耳机)、价格和在A到D列中的TRUE/FALSE值

为什么输出结果显示乱码?

StreamReader尝试处理此Excel文件时,控制台输出显示了潜在的问题。 您看到的不是可读数据,而是二进制内容,因为文件结构无法被解释为文本:

Visual Studio调试控制台展示了成功的程序执行,退出代码为0,并提示按任意键关闭窗口

现代 Excel 文件 (XLSX) 包含多个组件:工作表、样式、共享字符串和关系,所有这些都打包在一起。 这种复杂性需要能够理解 Excel 文件结构的专用库,这便引出了 IronXL。 该库在内部处理所有这些复杂操作的同时,提供了一个简单的 API,使其非常适合无法进行人工干预的自动化部署管道

如何使用 IronXL 读取 Excel 文件?

IronXL 为在 C# 中读取 Excel 文件提供了一个简便的解决方案。 与StreamReader不同,IronXL理解Excel的内部结构,并提供直观的方法来访问您的数据。 该库支持 Windows、Linux、macOS 以及 Docker 容器,非常适合现代跨平台应用程序。 对于DevOps团队来说,IronXL的零依赖架构意味着在部署过程中无需管理本机库或COM组件。

跨平台支持图表显示.NET在各版本、操作系统、开发环境和云平台(包括Windows、Linux、macOS、Docker、Azure和AWS)上的兼容性

首先,通过 NuGet 包管理器安装 IronXL:

Install-Package IronXL.Excel

通过Visual Studio中的包管理器控制台成功安装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}");
}
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
$vbLabelText   $csharpLabel

此代码成功加载了您的 Excel 文件,并提供了对单元格值的便捷访问。 WorkBook.Load 方法会自动检测文件格式(XLSXXLS、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 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 
        });
    }
}
Imports System
Imports System.Threading.Tasks
Imports Microsoft.AspNetCore.Mvc

' 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
$vbLabelText   $csharpLabel

如何从内存流中读取Excel?

实际应用中经常需要处理来自数据流而不是磁盘文件的 Excel 文件。 常见应用场景包括处理网页上传、从数据库检索文件,或处理来自 AWS S3Azure 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");
}
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 Using
$vbLabelText   $csharpLabel

FileStream还是网络流。 这种灵活性使您能够处理来自各种来源的 Excel 文件,而无需先将其保存到磁盘。该示例还演示了如何将工作表数据转换为 DataTable,该 DataTable 可与数据库和数据绑定场景无缝集成。 对于微服务架构,这种基于流的方法可最大限度地减少磁盘 I/O,从而提升性能。

内存流处理会产生什么结果?

Visual Studio调试控制台展示了读取Excel数据的输出,显示

在 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 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
    });
}
Imports System.IO
Imports Microsoft.AspNetCore.Mvc

<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
$vbLabelText   $csharpLabel

展示了一个C# Excel操作库的功能概览,拥有六个主要类别:创建、保存和导出、编辑工作簿、数据操作、保护您的工作簿,并在每个类别下面列出了详细的功能

如何在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");
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")
$vbLabelText   $csharpLabel

这些转换操作会在更改文件格式的同时保留您的数据。 在将 Excel 转换为 CSV 时,IronXL 默认会将第一个工作表转换为平面数据,但您可以指定要导出的工作表。 将 CSV 转换为 Excel 可生成格式规范的电子表格,既能保留数据类型,也便于后续进行格式调整公式添加

对于自动化数据管道,您还可以导出为 JSONXML 格式

// 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
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()
$vbLabelText   $csharpLabel

容器部署最佳实践

对于部署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"]

此 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 管道完美集成。

IronXL licensing page showing four pricing tiers (Lite, Plus, Professional, and Unlimited) with a toggle between IronXL and Iron Suite options, displaying perpetual license prices ranging from $999 to $3,999

准备好开始正确使用Excel文件了吗? 下载最适合您项目需求的 IronXL 免费试用版。 该库提供灵活的许可选项,涵盖开发、预发布和生产环境部署,并支持容器化环境及云原生应用程序。

常见问题解答

为什么StreamReader不能直接在C#中处理Excel文件?

StreamReader是为文本文件设计的,不支持Excel文件的二进制格式,这就是为什么您使用它读取Excel文档时可能会遇到乱码或异常的原因。相反,建议使用像IronXL这样的库来正确处理Excel文件。

在C#中导入Excel数据的推荐方法是什么?

在C#中导入Excel数据的推荐方法是使用IronXL。它允许开发人员无须Excel Interop即可读取和操作Excel文件,提供了更直接和高效的解决方案。

我可以在C#中不使用Excel Interop操作Excel文件吗?

是的,您可以通过使用IronXL来在C#中操作Excel文件,而无需Excel Interop。它提供了一种在您的C#应用程序中直接处理Excel文档的无缝方式。

使用IronXL处理Excel文件的好处是什么?

IronXL提供了多种好处,包括无需Microsoft Excel即可读写Excel文件,支持多种Excel格式,并且具有简化数据操作任务的强大API。

IronXL是否支持读取具有复杂数据类型的Excel文件?

是的,IronXL支持读取具有复杂数据类型的Excel文件,使您能够在C#应用程序中高效地处理多样的数据结构。

IronXL如何改进在C#中处理Excel文件的过程?

IronXL通过提供一个易于使用的接口来简化处理Excel文件的过程,消除了对Excel Interop的需求,减少了代码的复杂性,并提高了性能。

使用IronXL是否可以以不同格式读写Excel文件?

是的,IronXL支持多种Excel文件格式,如XLSX、XLS、CSV等,使您能够轻松地以各种格式读写文件。

IronXL 能高效处理大型 Excel 文件吗?

IronXL旨在高效处理大型Excel文件,提供强大的性能并在文件操作期间最大限度地减少内存使用。

是什么让IronXL成为C#开发人员处理Excel文件的合适选择?

IronXL是C#开发人员的合适选择,因为它提供了一整套用于轻松读取、写入和操作Excel文件的功能,无需Microsoft Excel或复杂的Interop依赖。

Curtis Chau
技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位,专注于前端开发,精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面,喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

除了开发之外,Curtis 对物联网 (IoT) 有浓厚的兴趣,探索将硬件和软件集成的新方法。在空闲时间,他喜欢玩游戏和构建 Discord 机器人,将他对技术的热爱与创造力相结合。

钢铁支援团队

我们每周 5 天,每天 24 小时在线。
聊天
电子邮件
打电话给我