VS2022 中 EPPlus 库安装、许可设置及使用指南

1 安装 EPPlus 库

请确保在项目中安装了 EPPlus 库。如果没有安装，你可以通过 NuGet 包管理器来安装 EPPlus。以下是安装步骤：

方法一、通过 Visual Studio 安装 EPPlus

• 1. 打开你的项目：在 Visual Studio 中打开你想要使用 EPPlus 的项目。
• 2. 打开 NuGet 包管理器控制台：
  • 点击菜单栏的 工具 (Tools)。
  • 选择 NuGet 包管理器 (NuGet Package Manager)。
  • 点击 程序包管理器控制台 (Package Manager Console)。
• 3. 在程序包管理器控制台安装 EPPlus： 在控制台中输入以下命令并按 Enter 键：

Install-Package EPPlus

方法二、通过 NuGet 包管理器 UI 安装 EPPlus

• 1. 打开 NuGet 包管理器：
  • 在解决方案资源管理器中右键点击你的项目。
  • 选择 管理 NuGet 程序包 (Manage NuGet Packages)。
• 2. 搜索并安装 EPPlus：
  • 在 NuGet 包管理器窗口中，点击顶部的 浏览 (Browse) 标签。
  • 在搜索框中输入 EPPlus 并按回车。

找到 EPPlus 包，并点击 安装 按钮。

2 设置许可证

EPPlus 从版本 5 开始引入了许可证机制。在使用 EPPlus 时，你需要设置 LicenseContext 属性。

你可以选择设置为 NonCommercial 以在非商业用途下免费使用，或者在商业用途下获取并设置商业许可证。

如果你没有设置许可证，运行将会报错。

3 简单示例 验证

以下是一个基础的代码示例，展示如何初始化 EPPlus 并写入 Excel 文件：

using OfficeOpenXml;
using System.IO;

public class ExcelHelper
{
    public void CreateFile()
    {
        ExcelPackage.LicenseContext = LicenseContext.NonCommercial;
        // 在此处添加具体的 Excel 操作逻辑
    }
}

4 所有项目共享同一个 EPPlus 库

建议在解决方案级别引用该库，以便多个项目共享同一个 EPPlus 实例配置，避免重复安装。