【亲测免费】 EPPlus 开源项目使用教程

1. 项目的目录结构及介绍

EPPlus 是一个用于处理 Excel 文件的 .NET 库。以下是 EPPlus 项目的目录结构及其介绍：

EPPlus/
├── docs/
│   ├── README.md
│   ├── CONTRIBUTING.md
│   ├── SECURITY.md
│   └── ...
├── src/
│   ├── EPPlus.Core/
│   ├── EPPlus.Core.Extensions/
│   └── ...
├── .gitignore
├── appveyor.yml
├── LICENSE.md
└── README.md

• docs/: 包含项目的文档文件，如 README.md、CONTRIBUTING.md 和 SECURITY.md 等。
• src/: 包含 EPPlus 的核心代码，包括 EPPlus.Core 和 EPPlus.Core.Extensions 等子目录。
• .gitignore: Git 的忽略文件配置。
• appveyor.yml: AppVeyor CI 的配置文件。
• LICENSE.md: 项目的许可证文件。
• README.md: 项目的介绍和使用说明。

2. 项目的启动文件介绍

EPPlus 项目本身是一个库，因此没有传统的“启动文件”。但你可以通过以下方式在你的项目中使用 EPPlus：

1. 安装 EPPlus: 使用 NuGet 包管理器安装 EPPlus：

   dotnet add package EPPlus
   

2. 创建 Excel 文件: 在你的代码中使用 EPPlus 创建和操作 Excel 文件：

   using OfficeOpenXml;
   using System.IO;
   
   class Program
   {
       static void Main(string[] args)
       {
           var file = new FileInfo("MyWorkbook.xlsx");
           using (var package = new ExcelPackage(file))
           {
               var worksheet = package.Workbook.Worksheets.Add("Sheet1");
               worksheet.Cells[1, 1].Value = "Hello, EPPlus!";
               package.Save();
           }
       }
   }
   

3. 项目的配置文件介绍

EPPlus 项目本身没有传统的配置文件，但你可以通过以下方式配置 EPPlus 的使用：

1. 设置 LicenseContext: 从 EPPlus 5 开始，需要设置 LicenseContext 以避免在调试模式下抛出 LicenseException。你可以在代码中设置：

   ExcelPackage.LicenseContext = LicenseContext.NonCommercial;
   

2. 通过 appSettings.json 配置: 你也可以在 appSettings.json 中配置 LicenseContext：

   {
     "EPPlus": {
       "ExcelPackage": {
         "LicenseContext": "NonCommercial"
       }
     }
   }
   

3. 通过环境变量配置: 你还可以通过设置环境变量 EPPlusLicenseContext 来配置：

   export EPPlusLicenseContext=NonCommercial
   

通过以上配置，你可以确保 EPPlus 在你的项目中正确运行。