C# 高效操作excel文件

code_shenbing2025-05-01 10:32

C#高效操作Excel文件指南

一、主流Excel处理方案对比

方案 类型 特点 适用场景
​​EPPlus​​ 第三方库 功能全面，性能好，支持.xlsx 复杂Excel操作，大数据量
​​NPOI​​ 第三方库 支持.xls和.xlsx，功能全面 兼容旧版Excel文件
​​ClosedXML​​ 第三方库 基于OpenXML，API简单 简单报表生成
​​Microsoft.Office.Interop.Excel​​ COM组件 功能最全，但性能差 必须使用Excel功能的场景
​​OpenXML SDK​​ 微软官方 底层API，性能好 需要精细控制Excel结构
​​GemBox.Spreadsheet​​ 商业库 性能极佳，功能全面 企业级高性能需求

二、EPPlus使用指南（推荐）

1. 安装与配置

cs 复制代码 
dotnet add package EPPlus

​​注意​​：EPPlus从5.0版本开始需要许可证(免费版有功能限制)

2. 基础操作

​​创建工作簿​​：

cs 复制代码 
using OfficeOpenXml;

// 创建新工作簿
var package = new ExcelPackage();
var worksheet = package.Workbook.Worksheets.Add("Sheet1");

// 写入数据
worksheet.Cells["A1"].Value = "姓名";
worksheet.Cells["B1"].Value = "年龄";
worksheet.Cells["A2"].Value = "张三";
worksheet.Cells["B2"].Value = 25;

// 保存文件
FileInfo file = new FileInfo("output.xlsx");
package.SaveAs(file);

​​读取Excel文件​​：

cs 复制代码 
using (var package = new ExcelPackage(new FileInfo("input.xlsx")))
{
    var worksheet = package.Workbook.Worksheets[0];
    int rowCount = worksheet.Dimension.Rows;
    int colCount = worksheet.Dimension.Columns;
    
    for (int row = 1; row <= rowCount; row++)
    {
        for (int col = 1; col <= colCount; col++)
        {
            var cellValue = worksheet.Cells[row, col].Value;
            Console.Write($"{cellValue}\t");
        }
        Console.WriteLine();
    }
}

3. 高效批量操作

​​批量写入数据​​：

cs 复制代码 
// 准备数据
var data = new List<Person>
{
    new Person { Name = "张三", Age = 25 },
    new Person { Name = "李四", Age = 30 }
};

// 批量写入
worksheet.Cells["A2"].LoadFromCollection(data, true, OfficeOpenXml.Table.TableStyles.Light1);

​​使用Range批量操作​​：

cs 复制代码 
// 设置样式
using (var range = worksheet.Cells["A1:B1"])
{
    range.Style.Font.Bold = true;
    range.Style.Fill.PatternType = OfficeOpenXml.Style.ExcelFillStyle.Solid;
    range.Style.Fill.BackgroundColor.SetColor(Color.LightBlue);
}

// 批量设置值
worksheet.Cells["A2:A3"].Value = new object[] { "张三", "李四" };
worksheet.Cells["B2:B3"].Value = new object[] { 25, 30 };

4. 高级功能

​​公式计算​​：

cs 复制代码 
worksheet.Cells["C2"].Formula = "A2+B2";
worksheet.Calculate(); // 手动计算
var result = worksheet.Cells["C2"].Value; // 获取计算结果

​​图表创建​​：

cs 复制代码 
var chart = worksheet.Drawings.AddChart("Chart1", eChartType.ColumnClustered);
chart.SetPosition(1, 0, 3, 0);
chart.SetSize(600, 400);
chart.Series.Add(worksheet.Cells["B2:B3"], worksheet.Cells["A2:A3"]);

​​数据验证​​：

cs 复制代码 
var validation = worksheet.DataValidations.AddListValidation("D2");
validation.Formula.Values.Add("选项1");
validation.Formula.Values.Add("选项2");
validation.Formula.Values.Add("选项3");

三、NPOI使用指南（兼容旧版Excel）

1. 安装与配置

cs 复制代码 
dotnet add package NPOI
dotnet add package NPOI.OOXML

2. 基础操作

​​创建Excel文件​​：

cs 复制代码 
using NPOI.SS.UserModel;
using NPOI.XSSF.UserModel;

// 创建工作簿
IWorkbook workbook = new XSSFWorkbook();
ISheet sheet = workbook.CreateSheet("Sheet1");

// 创建行和单元格
IRow row = sheet.CreateRow(0);
ICell cell = row.CreateCell(0);
cell.SetCellValue("姓名");

row = sheet.CreateRow(1);
cell = row.CreateCell(0);
cell.SetCellValue("张三");

​​读取Excel文件​​：

cs 复制代码 
using (var fileStream = new FileStream("input.xlsx", FileMode.Open, FileAccess.Read))
{
    IWorkbook workbook = new XSSFWorkbook(fileStream);
    ISheet sheet = workbook.GetSheetAt(0);
    
    for (int i = 0; i <= sheet.LastRowNum; i++)
    {
        IRow row = sheet.GetRow(i);
        if (row != null)
        {
            for (int j = 0; j < row.LastCellNum; j++)
            {
                ICell cell = row.GetCell(j);
                Console.Write($"{cell?.ToString()}\t");
            }
            Console.WriteLine();
        }
    }
}

3. 高效操作技巧

​​样式复用​​：

cs 复制代码 
ICellStyle style = workbook.CreateCellStyle();
style.FillForegroundColor = NPOI.HSSF.Util.HSSFColor.LightBlue.Index;
style.FillPattern = FillPattern.SolidForeground;

// 复用样式
for (int i = 0; i < 10; i++)
{
    IRow row = sheet.CreateRow(i);
    ICell cell = row.CreateCell(0);
    cell.CellStyle = style;
    cell.SetCellValue($"数据{i}");
}

​​大数据量处理​​：

cs 复制代码 
// 使用临时文件处理大数据
using (var fs = new FileStream("large.xlsx", FileMode.Create, FileAccess.Write))
{
    workbook.Write(fs);
}

四、ClosedXML使用指南（简单报表）

1. 安装与配置

复制代码 
dotnet add package ClosedXML

2. 基础操作

​​创建工作簿​​：

cs 复制代码 
using ClosedXML.Excel;

var workbook = new XLWorkbook();
var worksheet = workbook.Worksheets.Add("Sheet1");

// 写入数据
worksheet.Cell(1, 1).Value = "姓名";
worksheet.Cell(2, 1).Value = "张三";

// 保存文件
workbook.SaveAs("output.xlsx");

​​高级格式化​​：

cs 复制代码 
// 设置字体和颜色
worksheet.Cell(1, 1).Style.Font.Bold = true;
worksheet.Cell(1, 1).Style.Font.FontColor = XLColor.Red;

// 合并单元格
worksheet.Range(1, 1, 1, 3).Merge().SetValue("合并单元格示例");

// 添加条件格式
worksheet.Cell(2, 1).AddConditionalFormat()
    .WhenEquals("张三")
    .Fill.SetBackgroundColor(XLColor.LightGreen);

五、性能优化技巧

1. 减少内存占用

​​EPPlus优化​​：

cs 复制代码 
// 使用流式处理大数据
using (var package = new ExcelPackage())
{
    var worksheet = package.Workbook.Worksheets.Add("Sheet1");
    
    // 分批写入数据
    for (int i = 0; i < 100000; i++)
    {
        worksheet.Cells[i+1, 1].Value = $"数据{i}";
        
        // 每1000行刷新一次
        if (i % 1000 == 0)
        {
            package.Save(); // 可选：定期保存
        }
    }
    
    package.SaveAs(new FileInfo("large.xlsx"));
}

​​NPOI优化​​：

cs 复制代码 
// 使用SXSSFWorkbook处理大数据(仅XSSF)
// 注意：NPOI的SXSSFWorkbook实现有限，建议大数据用EPPlus

2. 异步操作

​​异步保存​​：

cs 复制代码 
// EPPlus不直接支持异步保存，但可以异步写入数据
await Task.Run(() =>
{
    using (var package = new ExcelPackage())
    {
        // 写入数据...
        package.SaveAs(new FileInfo("output.xlsx"));
    }
});

3. 缓存与复用

​​样式缓存​​：

cs 复制代码 
// EPPlus样式复用
var headerStyle = package.Workbook.Styles.CreateStyle();
headerStyle.Font.Bold = true;
headerStyle.Fill.PatternType = OfficeOpenXml.Style.ExcelFillStyle.Solid;
headerStyle.Fill.BackgroundColor.SetColor(Color.LightGray);

// 复用样式
worksheet.Cells["A1:D1"].Style = headerStyle;

六、常见问题解决

1. 内存泄漏

​​EPPlus内存管理​​：

cs 复制代码 
// 确保释放资源
using (var package = new ExcelPackage())
{
    // 操作...
} // 自动释放资源

​​NPOI内存泄漏​​：

cs 复制代码 
// 手动释放COM对象
Marshal.ReleaseComObject(worksheet);
Marshal.ReleaseComObject(workbook);

2. 大文件处理

​​分块处理​​：

cs 复制代码 
// 分块读取大文件
using (var package = new ExcelPackage(new FileInfo("large.xlsx")))
{
    var worksheet = package.Workbook.Worksheets[0];
    
    int batchSize = 1000;
    for (int startRow = 1; startRow <= worksheet.Dimension.Rows; startRow += batchSize)
    {
        int endRow = Math.Min(startRow + batchSize - 1, worksheet.Dimension.Rows);
        
        for (int row = startRow; row <= endRow; row++)
        {
            // 处理每行数据
        }
    }
}

3. 格式兼容性

​​跨版本兼容​​：

cs 复制代码 
// 检测Excel版本
if (Path.GetExtension(filePath).ToLower() == ".xls")
{
    // 使用HSSFWorkbook处理.xls
    IWorkbook workbook = new HSSFWorkbook();
}
else
{
    // 使用XSSFWorkbook处理.xlsx
    IWorkbook workbook = new XSSFWorkbook();
}

七、最佳实践建议

  1. ​​小文件操作​​：

    • 使用ClosedXML或EPPlus
    • 简单API，开发效率高

  2. ​​大文件操作​​：

    • 优先EPPlus
    • 分批处理数据
    • 考虑流式处理

  3. ​​兼容性要求​​：

    • 使用NPOI
    • 同时支持.xls和.xlsx

  4. ​​企业级应用​​：

    • 考虑GemBox.Spreadsheet(商业库)
    • 高性能，功能全面

  5. ​​Web应用​​：

    • 使用EPPlus内存优化模式
    • 及时释放资源
    • 考虑异步处理

八、性能对比测试

操作类型 EPPlus(ms) NPOI(ms) ClosedXML(ms)
创建1000行 15 45 20
读取1000行 10 35 15
写入公式 25 60 30
应用样式 20 50 25
生成图表 40 不支持 50

九、扩展功能实现

1. 动态报表生成

cs 复制代码 
public void GenerateReport(string templatePath, string outputPath, List<DataItem> data)
{
    using (var package = new ExcelPackage(new FileInfo(templatePath)))
    {
        var worksheet = package.Workbook.Worksheets[0];
        
        // 填充数据
        for (int i = 0; i < data.Count; i++)
        {
            worksheet.Cells[i+2, 1].Value = data[i].Name;
            worksheet.Cells[i+2, 2].Value = data[i].Value;
        }
        
        // 动态图表
        var chart = worksheet.Drawings.AddChart("Chart1", eChartType.ColumnClustered);
        chart.SetPosition(data.Count + 2, 0, 0, 0);
        chart.Series.Add(worksheet.Cells[2, 2, data.Count+1, 2], 
                        worksheet.Cells[2, 1, data.Count+1, 1]);
        
        package.SaveAs(new FileInfo(outputPath));
    }
}

2. 批量导出优化

cs 复制代码 
public async Task ExportLargeDataAsync(string filePath, IEnumerable<DataItem> data)
{
    // 使用流式处理
    await using (var stream = new FileStream(filePath, FileMode.Create, FileAccess.Write))
    {
        using (var package = new ExcelPackage(stream))
        {
            var worksheet = package.Workbook.Worksheets.Add("Data");
            
            // 写入表头
            worksheet.Cells[1, 1].Value = "ID";
            worksheet.Cells[1, 2].Value = "Name";
            
            int row = 2;
            foreach (var item in data)
            {
                worksheet.Cells[row, 1].Value = item.Id;
                worksheet.Cells[row, 2].Value = item.Name;
                row++;
                
                // 每1000行刷新一次
                if (row % 1000 == 0)
                {
                    await Task.Delay(10); // 避免UI线程阻塞
                }
            }
            
            package.Save();
        }
    }
}

十、总结

  1. ​​选择建议​​：

    • 简单报表 → ClosedXML
    • 复杂操作 → EPPlus
    • 兼容旧版 → NPOI
    • 企业级 → GemBox

  2. ​​性能关键点​​：

    • 分批处理大数据
    • 样式复用
    • 及时释放资源
    • 异步操作

  3. ​​扩展建议​​：

    • 使用模板引擎生成复杂报表
    • 实现缓存机制减少重复计算
    • 考虑使用内存映射文件处理超大文件
相关推荐
Ryo_Yuki24 分钟前
【上市公司文本分析】根据句号和分号进行文本分割，提取含有特定关键词的语句并导出为EXCEL
python·excel
钢铁男儿1 小时前
C#结构体性能暴击指南：从内存陷阱到零损耗实战
开发语言·c#
MZZ骏马2 小时前
C#接受文件
开发语言·c#
ou.cs3 小时前
wpf 控件开发中，OnApplyTemplate 和 OnContentRendered区别
c#·.net·wpf
忧郁的蛋~5 小时前
.NET Core 实现缓存的预热的方式
缓存·c#·.net·.netcore
守护安静星空6 小时前
Qt编辑excel：QtXlsxWriter
excel
csdn_aspnet1 天前
C# .NET Core 源代码生成器(dotnet source generators)
c#·.netcore
时光追逐者1 天前
C#/.NET/.NET Core技术前沿周刊 | 第 42 期（2025年6.9-6.15）
c#·.net·.netcore
z2014z2 天前
第3章 C#编程概述 笔记
笔记·c#
葡萄城技术团队2 天前
基于 C# 和 .NET 的 Spread.NET 数据处理实战
c#
热门推荐
01扣子（coze）实战|我用扣子搭建了一个自动分析小红薯笔记内容的AI应用|详细步骤拆解02Coze扣子平台完整体验和实践（附国内和国际版对比）03KGG转MP3工具|非KGM文件|解密音频04DeepSeek各版本说明与优缺点分析05零代码入门 | Coze——让大模型接入自己的数据库06从零安装 LLaMA-Factory 微调 Qwen 大模型成功及所有的坑07AI Agent | Coze 插件使用指南：从功能解析到实操步骤08扣子空间的使用教程与大模型技术思考09YOLOv8入门 | 重要性能衡量指标、训练结果评价及分析及影响mAP的因素【发论文关注的指标】10ADS仿真低噪声放大器学习笔记