EPPlus 项目常见问题解决方案

EPPlus 项目常见问题解决方案

EPPlus EPPlus-Excel spreadsheets for .NET 项目地址: https://gitcode.com/gh_mirrors/epp/EPPlus

1. 项目基础介绍和主要编程语言

EPPlus 是一个开源项目，它提供了一种在 .NET 环境下处理 Excel 文档的方式。与 Microsoft Office 的 Excel 不同，EPPlus 允许开发者在不依赖 Excel 应用程序的情况下创建、读取和编辑 Excel 文件。它使用 C# 编程语言编写，兼容 .NET Framework 和 .NET Core，为开发者提供了一个高效且功能丰富的库。

2. 新手在使用这个项目时需特别注意的3个问题及解决步骤

问题1：如何设置项目的许可证上下文？

**问题描述：**EPPlus 从版本 5 开始，更改了许可证模型，需要设置许可证上下文才能正常使用。

解决步骤：

1. 确定你的使用环境是非商业还是商业。非商业使用可以继续免费，商业使用需要购买商业许可证。
2. 根据使用环境，通过以下任一方式设置许可证上下文：
   • **代码设置：**在 ExcelPackage 类中设置 LicenseContext 属性：

     ExcelPackage.LicenseContext = LicenseContext.Commercial; // 商业使用
     ExcelPackage.LicenseContext = LicenseContext.NonCommercial; // 非商业使用
     

   • **appsettings.json 设置：**在 appsettings.json 文件中添加以下内容：

     {
       "EPPlus": {
         "ExcelPackage": {
           "LicenseContext": "Commercial" // 或 "NonCommercial"
         }
       }
     }
     

   • **web.config 设置：**在 web.config 文件中添加以下内容：

     <appSettings>
       <add key="EPPlus:ExcelPackage-LicenseContext" value="Commercial" /> <!-- 或 "NonCommercial" -->
     </appSettings>
     

   • **环境变量设置：**设置环境变量 EPPlusLicenseContext 为 Commercial 或 NonCommercial。

问题2：如何在项目中创建一个新的 Excel 文件？

**问题描述：**新手可能不清楚如何开始使用 EPPlus 创建一个新的 Excel 文件。

解决步骤：

1. 引入 EPPlus 库。
2. 创建一个新的 ExcelPackage 实例，并指定一个文件路径。
3. 添加一个工作表（Worksheet）。
4. 向工作表写入数据。
5. 保存并关闭 ExcelPackage 实例。

示例代码：

using OfficeOpenXml;

var fileInfo = new FileInfo("MyWorkbook.xlsx");
using (var package = new ExcelPackage(fileInfo))
{
    var worksheet = package.Workbook.Worksheets.Add("Sheet1");
    worksheet.Cells["A1"].Value = "Hello";
    worksheet.Cells["B1"].Value = "World";
    package.Save();
}

问题3：如何处理 Excel 中的公式？

**问题描述：**当处理含有公式的 Excel 文件时，可能需要特别注意公式的计算和处理。

解决步骤：

1. 确保工作簿在读取或写入数据前已经启用了公式计算。
2. 使用 ExcelPackage 的 Calculate 方法来计算工作表中的公式。

示例代码：

using OfficeOpenXml;

var fileInfo = new FileInfo("MyWorkbook.xlsx");
using (var package = new ExcelPackage(fileInfo))
{
    var worksheet = package.Workbook.Worksheets["Sheet1"];
    // 假设 B1 单元格中有一个公式 =A1*2
    worksheet.Cells["B1"].Formula = "=A1*2";
    worksheet.Cells["B1"].Calculate();
    // 现在 B1 单元格将显示 A1 的两倍值
    package.Save();
}

EPPlus EPPlus-Excel spreadsheets for .NET 项目地址: https://gitcode.com/gh_mirrors/epp/EPPlus