在 WinForm 项目中调用 EPPlus 8 将 `DataGridView` 数据导出到 Excel 时，遇到“License Exception”错误是常见问题。此错误的根源在于 EPPlus 自 5.0 版本起引入了新的**双重许可协议**，要求开发者在代码中明确指定许可证上下文，否则在运行时（尤其在调用 `ExcelPackage` 的构造函数或 `SaveAs` 方法时）会抛出异常 [ref_1]。下表对比了 EPPlus 4.x 与 EPPlus 5+ 在处理许可证方面的主要差异。 | 特性/版本 | **EPPlus 4.x 及更早版本** | **EPPlus 5.0 及更高版本** | | :--- | :--- | :--- | | **许可模型** | 采用 **LGPL** (GNU Lesser General Public License) 协议。 | 采用 **PolyForm Noncommercial License 1.0.0** (非商业) 和 **商业许可证** 的**双授权**模式 [ref_1]。 | | **代码要求** | 无需在代码中进行任何许可证声明。 | **必须**在首次使用 `ExcelPackage` 类**之前**，显式设置 `ExcelPackage.LicenseContext` 属性。 | | **错误提示** | 无相关许可证异常。 | 当未设置或设置不正确时，抛出 `LicenseException` 或类似的异常信息。 | | **主要影响** | 可免费用于商业和非商业项目，但需遵守 LGPL 条款。 | **非商业项目**（如个人、教育、开源）可免费使用，但需声明；**商业项目**必须购买商业许可证 [ref_1]。 | 该错误的解决方案是**在应用程序启动或首次使用 `ExcelPackage` 之前，正确设置 `ExcelPackage.LicenseContext` 属性**。 ### **解决方案一：全局设置（推荐）** 这是最常见且最简洁的解决方案，通常在程序入口点（如 `Program.cs` 或主窗体的构造函数开头）设置一次即可全局生效。 **1. 在 `Program.cs` 的 `Main` 方法中设置：** 这是最推荐的方案，确保在应用程序启动的瞬间就完成配置。 ```csharp using System; using System.Windows.Forms; using OfficeOpenXml; // 必须引用 EPPlus 命名空间 namespace YourWinFormApp { static class Program { /// <summary> /// 应用程序的主入口点。 /// </summary> [STAThread] static void Main() { // 解决方案：在应用程序启动时设置 EPPlus 许可证上下文 [ref_1] // 根据您的使用场景选择正确的 LicenseContext ExcelPackage.LicenseContext = LicenseContext.NonCommercial; // 用于非商业项目 // ExcelPackage.LicenseContext = LicenseContext.Commercial; // 用于已购买商业许可证的商业项目 Application.EnableVisualStyles(); Application.SetCompatibleTextRenderingDefault(false); Application.Run(new MainForm()); // 启动主窗体 } } } ``` **2. 在主窗体构造函数中设置：** 如果项目结构简单，也可在主窗体的构造函数开始处设置。 ```csharp using OfficeOpenXml; using System.Windows.Forms; namespace YourWinFormApp { public partial class MainForm : Form { public MainForm() { // 在初始化组件前设置许可证 ExcelPackage.LicenseContext = LicenseContext.NonCommercial; // 或 LicenseContext.Commercial InitializeComponent(); // ... 其他初始化代码 } // ... 其他代码，例如导出按钮的点击事件 private void btnExport_Click(object sender, System.EventArgs e) { // 此时创建 ExcelPackage 不会再引发 LicenseException using (var package = new ExcelPackage()) { // ... 导出逻辑 } } } } ``` ### **解决方案二：在导出方法内部设置** 此方案将许可证设置放在具体的导出函数内部，确保了在该函数被调用时上下文已正确设置。但需注意，如果程序中有多处使用 EPPlus 的地方，每处都需设置，不够便捷。 ```csharp using OfficeOpenXml; using System.IO; // ... 其他 using 语句 private void ExportDataGridViewToExcel(DataGridView dgv, string filePath) { // 在创建 ExcelPackage 实例之前，必须设置 LicenseContext [ref_1] ExcelPackage.LicenseContext = LicenseContext.NonCommercial; // 关键步骤，消除 LicenseException using (ExcelPackage excelPackage = new ExcelPackage()) // 此时创建实例是安全的 { ExcelWorksheet worksheet = excelPackage.Workbook.Worksheets.Add("Data"); // ... 遍历 DataGridView 写入数据的代码 ... // 示例：写入表头 for (int i = 0; i < dgv.Columns.Count; i++) { worksheet.Cells[1, i + 1].Value = dgv.Columns[i].HeaderText; } // ... 保存文件 ... excelPackage.SaveAs(new FileInfo(filePath)); } } ``` ### **`LicenseContext` 枚举详解与选择** `LicenseContext` 枚举有两个值，正确选择是解决问题的关键： | 枚举值 | 含义与适用场景 | 如何判断 | | :--- | :--- | :--- | | **`LicenseContext.NonCommercial`** | **非商业用途**。适用于个人项目、学术研究、开源软件（符合 PolyForm Noncommercial License 条款）、内部非盈利性工具等。 | 您的软件是否用于销售、作为商业产品或服务的一部分、或在营利组织内部为商业目的而使用？如果不是，通常可选择此项。 | | **`LicenseContext.Commercial`** | **商业用途**。适用于所有商业软件、SaaS服务、企业内部使用的盈利性工具、为第三方客户定制的解决方案等。 | 如果您的使用场景属于商业用途，**必须**从 [EPPlus Software](https://www.epplussoftware.com/) 购买商业许可证，并在代码中设置此值。 | **重要提示**：错误地使用 `LicenseContext.NonCommercial` 于商业项目，或使用了 `LicenseContext.Commercial` 却未购买商业许可证，均**违反了 EPPlus 的许可协议**，可能导致法律风险，并且在未来版本升级或某些功能调用时可能仍然会遇到问题或限制。 ### **完整的、已修复许可证错误的导出示例** 以下是一个集成了上述解决方案、功能完整的 `DataGridView` 导出到 Excel 的方法，可直接使用。 ```csharp using OfficeOpenXml; using System; using System.IO; using System.Windows.Forms; public partial class MainForm : Form { // 假设窗体上有一个 DataGridView 控件 dataGridView1 和一个按钮 btnExport private void btnExport_Click(object sender, EventArgs e) { using (SaveFileDialog sfd = new SaveFileDialog()) { sfd.Filter = "Excel Workbook (*.xlsx)|*.xlsx"; sfd.FileName = "ExportedData.xlsx"; if (sfd.ShowDialog() == DialogResult.OK) { try { // 调用修复了许可证问题的导出方法 ExportToExcel(dataGridView1, sfd.FileName); MessageBox.Show("导出成功！", "信息", MessageBoxButtons.OK, MessageBoxIcon.Information); } catch (Exception ex) { MessageBox.Show($"导出失败：{ex.Message}", "错误", MessageBoxButtons.OK, MessageBoxIcon.Error); } } } } /// <summary> /// 将 DataGridView 数据导出到 Excel 文件，已处理 EPPlus 8 的许可证问题 [ref_1]。 /// </summary> /// <param name="dgv">源 DataGridView 控件。</param> /// <param name="filePath">目标 Excel 文件路径。</param> private void ExportToExcel(DataGridView dgv, string filePath) { // 关键步骤：设置 EPPlus 许可证上下文，防止 LicenseException // 请根据您的项目性质（商业/非商业）选择正确的枚举值 ExcelPackage.LicenseContext = LicenseContext.NonCommercial; // 或 LicenseContext.Commercial using (var package = new ExcelPackage()) { var worksheet = package.Workbook.Worksheets.Add("Sheet1"); // 1. 导出列标题（表头） for (int col = 0; col < dgv.Columns.Count; col++) { worksheet.Cells[1, col + 1].Value = dgv.Columns[col].HeaderText; // 可选：设置表头样式 worksheet.Cells[1, col + 1].Style.Font.Bold = true; } // 2. 导出数据行 int rowIndex = 2; foreach (DataGridViewRow row in dgv.Rows) { if (!row.IsNewRow) // 跳过末尾的“新行” { for (int col = 0; col < dgv.Columns.Count; col++) { worksheet.Cells[rowIndex, col + 1].Value = row.Cells[col].Value; } rowIndex++; } } // 3. （可选）自动调整列宽 if (worksheet.Dimension != null) { worksheet.Cells[worksheet.Dimension.Address].AutoFitColumns(); } // 4. 保存文件 package.SaveAs(new FileInfo(filePath)); } } } ``` ### **故障排查清单** 如果按照上述方法设置后，问题依旧，请按以下清单排查： 1. **设置时机是否正确？**：确保 `ExcelPackage.LicenseContext = ...` 的代码行**执行于任何 `ExcelPackage` 对象实例化之前**。最好在程序启动时设置。 2. **EPPlus 版本确认**：在项目的 NuGet 包管理器中，确认安装的 EPPlus 版本是否为 **5.0 或更高**。4.x 版本无需此设置。可通过 `Install-Package EPPlus` 安装最新版。 3. **许可证类型是否匹配？**：仔细评估您的项目用途。若为商业用途，必须购买商业许可证并使用 `LicenseContext.Commercial`。 4. **是否存在多个设置点冲突？**：检查代码中是否有多处设置了 `LicenseContext`，且值不一致。应统一。 5. **清理并重新生成解决方案**：有时旧的编译缓存可能导致问题。尝试在 Visual Studio 中执行“清理解决方案”，然后“重新生成解决方案”。 6. **检查异常堆栈跟踪**：仔细阅读异常信息的完整堆栈跟踪，确认错误是否确实来自 `ExcelPackage` 构造函数，以排除其他原因。