C# Excel操作类EPPlus

摘要

EPPlus 是一个流行的用于操作 Excel 文件的开源库，适用于 C# 和 .NET 环境。它提供了丰富的功能，能够轻松地读取、写入和格式化 Excel 文件，使得在 C# 中进行 Excel 文件处理变得更加简单和高效。EPPlus 不需要安装 Microsoft Office 或 Excel，因为它完全是用 C# 编写的，并且直接操作 Excel 文件的数据。

支持 Excel 文件格式：EPPlus 支持读取和写入 Office Open XML (XLSX) 格式的 Excel 文件，这是 Microsoft Excel 2007 及以后版本的默认文件格式。它不支持旧的二进制格式（XLS）

正文

EPPlus 是在 MIT 许可下发布的开源项目，因此你可以免费使用和修改它，也可以将其用于商业项目。它的源代码也是公开可用的，你可以自由查看和学习其中的实现细节。

Nuget 安装epplus，这里版本选上我基本就是5.0以前的够用了。

Announcement: This is the last version of EPPlus under the LGPL License

EPPlus will from version 5 be licensed under the Polyform Noncommercial 1.0.0 license.

With the new license EPPlus is still free to use in some cases, but will require a commercial license to be used in a commercial business.

More information on the license change on our website

常用方法:

Load：将已有的 Excel 文件加载到 ExcelPackage 对象中。

C#
ExcelPackage package = new ExcelPackage();
package.Load(FileInfo file);

Save：保存ExcelPackage对象到文件或流。

C#
package.SaveAs(FileInfo file);
package.SaveAs(Stream stream);

获取值：获取单元格的值。

C#
object value = worksheet.Cells[row, column].Value;

设置值：设置单元格的值。

C#
worksheet.Cells[row, column].Value = value;

常用属性:

获取 ExcelWorkbook 对象，表示工作簿。

C#
ExcelWorkbook workbook = package.Workbook;

工作表：获取工作簿中的工作表集合。

C#
ExcelWorksheets worksheets = workbook.Worksheets;

单元格：获取工作表中的单元格集合。

C#
ExcelRange cells = worksheet.Cells;

值：获取或设置单元格的值。

C#
object value = cell.Value;
cell.Value = value;

地址：获取单元格或范围的地址。

C#
string address = cell.Address;

先做一个导入的例子

导入这样一个全国的省市信息

C#
private void Import()
{
    lsvMain.Items.Clear();  
    string filePath = "./地区.xlsx";

    // 检查文件是否存在
    if (!File.Exists(filePath))
    {
        MessageBox.Show($"文件没有找到{filePath}");
        return;
    }

    // 使用 EPPlus 打开 Excel 文件
    using (var package = new ExcelPackage(new FileInfo(filePath)))
    {
        // 获取工作表
        // 可以用Sheet的索引package.Workbook.Worksheets[0]; 
        // 也可用Sheet名字
        ExcelWorksheet worksheet = package.Workbook.Worksheets["Sheet1"]; 

        // 获取工作表的行数和列数,在实际工作中，用户给的excel不规范，
        // 可能需要通过固定列数，行数通过某些列为空判断结束
        int rowCount = worksheet.Dimension.Rows;
        int columnCount = worksheet.Dimension.Columns;

        // 读取数据并显示在控制台上
        // 这个因为有行头，从第二行开始
        for (int row = 2; row <= rowCount; row++)
        {
            ListViewItem item = new ListViewItem();
            item.Text= worksheet.Cells[row, 1].Value.ToString();
            for (int col = 2; col <= columnCount; col++)
            {
                var cellValue = worksheet.Cells[row, col].Value;
                item.SubItems.Add(cellValue==null?"": cellValue.ToString());
            }
            lsvMain.Items.Add(item);
        }
    }

    for (int i = 0; i < lsvMain.Columns.Count; i++)
    {
        lsvMain.Columns[i].Width = -2;//宽度按内容计算
    }
  
}

注：行与列的有效判断是个问题，再有就是行列都是从1开始，不像C#中其它基本是0开始索引。

导出Excel

先修改一下导入，需要将数据保存到List中

在导入时，增加

C#
areas.Add(new Area
{
    id = int.Parse(item.Text),
    type = int.Parse(item.SubItems[1].Text),
    parent_id = int.Parse(item.SubItems[2].Text),
    name = item.SubItems[3].Text
});

C#
public class Area
{
    public int id { get; set; }
    public int type { get; set; }
    public int parent_id { get; set; }
    public string name { get; set; }
}

C#
private void btnExport_Click(object sender, EventArgs e)
{
    //找出所有省
    var provinces = areas.Where(x => x.type == 2);
    var citys = from t in provinces
                from c in areas
                where c.type == 3 && c.parent_id == t.id
                select new
                {
                    province = t.name,
                    city = c.name
                } into b
                group b by new { province = b.province } into g
                select new
                {
                    province = g.Key.province,
                    qty = g.Count()
                };

    // 使用模板
    string templatePath = "./统计城市.xlsx";

    // 找开模板文件
    FileInfo templateFile = new FileInfo(templatePath);

    //另存的文件
    string strDesFileName = "./" + DateTime.Now.ToString("yyyyMMddHHmmss") + ".xlsx";
    FileInfo desFile = new FileInfo(strDesFileName);

    // 载入到package
    using (ExcelPackage package = new ExcelPackage(desFile,templateFile))
    {
        //找到sheet
        ExcelWorksheet worksheet = package.Workbook.Worksheets["Sheet1"];
        int row = 2;
        foreach (var item in citys.ToList())
        {
            worksheet.Cells[row, 1].Value = item.province;
            worksheet.Cells[row, 2].Value = item.qty;
            row++;
        }
        package.Save();
    }
}

注意，导出有几个技巧，一般我们都是有导出模板，而且有可以有一些公式在Excel中，可用worksheet.Calculate()，激活公式。

目录

摘要

正文

导入这样一个全国的省市信息

导出Excel