如何在未安装 Excel 的情况下使用 C# 读取 OpenOffice Excel 文件

如何在.NET项目中安装IronXL？

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

如何在C#中加载OpenOffice或Excel文件？

IronXL通过WorkBook.Load方法对ODS、XLS、XLSX和CSV文件进行相同的处理。 您传递绝对或相对文件路径，库从文件头中检测格式，而不仅仅是扩展名。 这意味着将文件从.xlsx后仍然可以正确读取。

using IronXL;

// Load an OpenDocument Spreadsheet (.ods) produced by LibreOffice Calc or OpenOffice
WorkBook workbook = WorkBook.Load("quarterly_report.ods");

// Access the first worksheet by index
WorkSheet sheet = workbook.WorkSheets[0];

// Read a cell value
string companyName = sheet["A1"].StringValue;
int recordCount   = sheet["B1"].IntValue;

Console.WriteLine($"Company : {companyName}");
Console.WriteLine($"Records : {recordCount}");

using IronXL;

// Load an OpenDocument Spreadsheet (.ods) produced by LibreOffice Calc or OpenOffice
WorkBook workbook = WorkBook.Load("quarterly_report.ods");

// Access the first worksheet by index
WorkSheet sheet = workbook.WorkSheets[0];

// Read a cell value
string companyName = sheet["A1"].StringValue;
int recordCount   = sheet["B1"].IntValue;

Console.WriteLine($"Company : {companyName}");
Console.WriteLine($"Records : {recordCount}");

对于XLSX和XLS文件使用相同的调用——只需更改路径即可。 WorkBook.Load返回相同的强类型对象，无论源格式如何，因此您的代码保持一致，无论文件来自Microsoft Excel、LibreOffice或任何其他ODF兼容应用程序。

如何读取工作表中的每一行和单元格？

using IronXL;

WorkBook workbook  = WorkBook.Load("customers.xlsx");
WorkSheet worksheet = workbook.WorkSheets[0];

Console.WriteLine($"Total rows    : {worksheet.RowCount}");
Console.WriteLine($"Total columns : {worksheet.ColumnCount}");
Console.WriteLine();

foreach (var row in worksheet.Rows)
{
    foreach (var cell in row)
    {
        if (!cell.IsEmpty)
            Console.Write($"{cell.StringValue,-20}");
    }
    Console.WriteLine();
}

using IronXL;

WorkBook workbook  = WorkBook.Load("customers.xlsx");
WorkSheet worksheet = workbook.WorkSheets[0];

Console.WriteLine($"Total rows    : {worksheet.RowCount}");
Console.WriteLine($"Total columns : {worksheet.ColumnCount}");
Console.WriteLine();

foreach (var row in worksheet.Rows)
{
    foreach (var cell in row)
    {
        if (!cell.IsEmpty)
            Console.Write($"{cell.StringValue,-20}");
    }
    Console.WriteLine();
}

如何从单元格中提取类型化的值？

using IronXL;

WorkBook workbook = WorkBook.Load("inventory.xlsx");
WorkSheet sheet   = workbook.GetWorkSheet("Products");

// Typed accessors handle conversion automatically
string  productName = sheet["A2"].StringValue;
int     quantity    = sheet["B2"].IntValue;
decimal unitPrice   = sheet["C2"].DecimalValue;
bool    inStock     = sheet["D2"].BoolValue;
DateTime? lastAudit = sheet["E2"].DateTimeValue;

Console.WriteLine($"Product  : {productName}");
Console.WriteLine($"Qty      : {quantity}");
Console.WriteLine($"Price    : {unitPrice:C}");
Console.WriteLine($"In Stock : {inStock}");
Console.WriteLine($"Audited  : {lastAudit?.ToString("d") ?? "Never"}");

using IronXL;

WorkBook workbook = WorkBook.Load("inventory.xlsx");
WorkSheet sheet   = workbook.GetWorkSheet("Products");

// Typed accessors handle conversion automatically
string  productName = sheet["A2"].StringValue;
int     quantity    = sheet["B2"].IntValue;
decimal unitPrice   = sheet["C2"].DecimalValue;
bool    inStock     = sheet["D2"].BoolValue;
DateTime? lastAudit = sheet["E2"].DateTimeValue;

Console.WriteLine($"Product  : {productName}");
Console.WriteLine($"Qty      : {quantity}");
Console.WriteLine($"Price    : {unitPrice:C}");
Console.WriteLine($"In Stock : {inStock}");
Console.WriteLine($"Audited  : {lastAudit?.ToString("d") ?? "Never"}");

如何处理多个命名工作表？

using IronXL;

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

// Option 1: access by name (throws if the sheet does not exist)
WorkSheet januarySheet = workbook.GetWorkSheet("January");

// Option 2: iterate all sheets in the workbook
foreach (WorkSheet ws in workbook.WorkSheets)
{
    Console.WriteLine($"Sheet: {ws.Name}  |  Rows: {ws.RowCount}");

    // Read the header row from each sheet
    string header = ws["A1"].StringValue;
    Console.WriteLine($"  Header: {header}");
}

// Option 3: access by zero-based index
WorkSheet lastSheet = workbook.WorkSheets[workbook.WorkSheets.Count - 1];
Console.WriteLine($"Last sheet: {lastSheet.Name}");

using IronXL;

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

// Option 1: access by name (throws if the sheet does not exist)
WorkSheet januarySheet = workbook.GetWorkSheet("January");

// Option 2: iterate all sheets in the workbook
foreach (WorkSheet ws in workbook.WorkSheets)
{
    Console.WriteLine($"Sheet: {ws.Name}  |  Rows: {ws.RowCount}");

    // Read the header row from each sheet
    string header = ws["A1"].StringValue;
    Console.WriteLine($"  Header: {header}");
}

// Option 3: access by zero-based index
WorkSheet lastSheet = workbook.WorkSheets[workbook.WorkSheets.Count - 1];
Console.WriteLine($"Last sheet: {lastSheet.Name}");

如何处理合并单元格和格式化区域？

报告和仪表板频繁使用合并单元格作为标题、组合标签和汇总行。 IronXL从合并区域的左上角单元格读取值，正如Excel显示的那样：

using IronXL;

WorkBook workbook = WorkBook.Load("report_with_merges.xlsx");
WorkSheet sheet   = workbook.DefaultWorkSheet;

// The merged region A1:D1 stores its value in cell A1
string reportTitle = sheet["A1"].StringValue;
Console.WriteLine($"Report title : {reportTitle}");

// Read cell formatting metadata
var titleCell = sheet["A1"];
Console.WriteLine($"Bold         : {titleCell.Style.Font.Bold}");
Console.WriteLine($"Font size    : {titleCell.Style.Font.Height}");

// Scan an entire column for non-empty section headers
foreach (var cell in sheet["A1:A100"])
{
    if (!cell.IsEmpty && cell.Style.Font.Bold)
        Console.WriteLine($"Section header at {cell.AddressString}: {cell.StringValue}");
}

using IronXL;

WorkBook workbook = WorkBook.Load("report_with_merges.xlsx");
WorkSheet sheet   = workbook.DefaultWorkSheet;

// The merged region A1:D1 stores its value in cell A1
string reportTitle = sheet["A1"].StringValue;
Console.WriteLine($"Report title : {reportTitle}");

// Read cell formatting metadata
var titleCell = sheet["A1"];
Console.WriteLine($"Bold         : {titleCell.Style.Font.Bold}");
Console.WriteLine($"Font size    : {titleCell.Style.Font.Height}");

// Scan an entire column for non-empty section headers
foreach (var cell in sheet["A1:A100"])
{
    if (!cell.IsEmpty && cell.Style.Font.Bold)
        Console.WriteLine($"Section header at {cell.AddressString}: {cell.StringValue}");
}

Style属性树镜像OOXML SpreadsheetML规范的结构，因此如果您使用过Open XML SDK，属性名称会感到熟悉。 不过，IronXL将所有复杂性包装在一个简洁的API中，不需要您进行任何XML操作。

如何使用相同的API导入CSV文件？

数据库导出、CRM系统和传统应用程序生成的CSV文件可以通过相同的WorkBook.Load调用读取。 IronXL从文件内容中推断分隔符：

using IronXL;

// Load a comma-separated values file -- same method, same API
WorkBook csvWorkbook  = WorkBook.Load("export.csv");
WorkSheet csvSheet    = csvWorkbook.DefaultWorkSheet;

Console.WriteLine($"CSV rows loaded: {csvSheet.RowCount}");

// Process rows exactly like any other worksheet
foreach (var row in csvSheet.Rows)
{
    string id   = row[0].StringValue;
    string name = row[1].StringValue;
    Console.WriteLine($"{id,-10} {name}");
}

using IronXL;

// Load a comma-separated values file -- same method, same API
WorkBook csvWorkbook  = WorkBook.Load("export.csv");
WorkSheet csvSheet    = csvWorkbook.DefaultWorkSheet;

Console.WriteLine($"CSV rows loaded: {csvSheet.RowCount}");

// Process rows exactly like any other worksheet
foreach (var row in csvSheet.Rows)
{
    string id   = row[0].StringValue;
    string name = row[1].StringValue;
    Console.WriteLine($"{id,-10} {name}");
}

加载后，您可以使用csvWorkbook.SaveAs("output.xlsx")将数据保存为XLSX。 这是CSV到Excel转换管道的常见模式——接收CSV文件，用计算列或格式化丰富它，并向用户返回格式化的XLSX报告。

对于制表符分隔文件或自定义分隔符，请使用WorkBook.LoadCSV("file.tsv", file翻译格式: ExcelFile翻译格式.TSV)显式指定格式。

IronXL与Microsoft.Office.Interop.Excel如何比较？

如何将Excel处理部署到Linux和Docker？

服务器部署是IronXL不依赖Excel的优势最明显的地方。 您在Windows上编写的代码可以在Ubuntu、Alpine Linux或macOS上不作修改地运行。 对于容器化部署，您的Dockerfile不需要特殊配置：

# Standard .NET runtime image -- no Office packages needed
FROM mcr.microsoft.com/dotnet/runtime:10.0
WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "ExcelProcessor.dll"]

# Standard .NET runtime image -- no Office packages needed
FROM mcr.microsoft.com/dotnet/runtime:10.0
WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "ExcelProcessor.dll"]

对于Azure Functions和AWS Lambda，IronXL可以在托管运行时内无需额外配置地工作。 冷启动的开销很小，因为没有COM初始化步骤。

线程安全是内置的：多个线程可以同时打开不同的WorkBook实例而无需协调。 如果您需要并行处理数千个文件——例如，在一个摄取用户上传电子表格的后台作业中——您可以在一组Task.WhenAll，而不会有损坏的风险。

内存使用保持可预测，因为IronXL仅将请求的工作表加载到内存中，而不是在初始化时加载整个工作簿。 对于非常大的文件，这一区别很重要：一个具有十个50MB工作表的工作簿不需要500MB内存来读取一个单一工作表。 IronXL性能文档涵盖了其他处理高容量文件处理场景的策略。

接下来您的步骤是什么？

在您的项目中验证IronXL的最快方法是安装NuGet包，并对您环境中的真实文件运行本指南中的示例。 当您准备好用于生产时，免费试用许可证解锁所有功能，无需代码更改。

探索补充文件读取的相关IronXL功能：

• 在C#中编写和创建Excel文件——以编程方式构建报告和数据导出
• 格式化单元格、行和列——在代码中应用颜色、字体和边框
• 在C#中使用Excel公式——读取和写入公式单元格
• 在.NET中将Excel转换为PDF——从电子表格数据生成PDF报告
• IronXL API文档——所有类和方法的完整参考
• IronXL许可和定价——为个人开发者和企业团队提供的选项
• IronXL NuGet页面——所有项目类型的安装说明
• IronXL教程——常见使用案例的逐步指南
• 将IronXL与EPPlus进行比较——功能和许可对比
• IronXL产品首页——功能概述和入门资源

有关许可、跨平台支持或特定文件格式要求的问题，IronXL支持团队通过实时聊天和电子邮件提供服务。

立即开始使用 IronXL。

免费开始