平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“C#代码实现方法在Excel中编辑或删除批注”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际采用顺序，把思路、关键写法和容易踩坑的地方讲清楚，便于大家直接对照操作。
在这个场景下，Excel 批注是添加到指定单元格中的附加说明或备注，用来补充信息、提供解释或向其他用户分享提示。添加批注后，用户能够根据需对其进行格式设置、编辑、删除以及显示或隐藏操作。
落到代码里，下面会介绍如何借助编程方式编辑或删除 Excel 工作表中的已有批注，并以 .NET 环境下的实现方法为例进行演示。
安装所需组件
在这个场景下，首先，需将相关 DLL 文件添加到 .NET 项目中作为引用。能够借助下载对应的 DLL 文件，或者采用 NuGet 包管理器直接安装所需组件。完成安装后，即可在项目里调用相关功能来处理 Excel 文件。
PM> Install-Package Spire.XLS
编辑 Excel 中的批注
结合项目来看，在 Excel 工作簿中添加批注后，有时可能需对已有批注进行修改，比如更新内容、调整大小或更改显示方式。下面列出了一些常用的类和属性，用来拿到已有批注，同时设置新的文本内容以及格式。
| 名称 | 描述 |
|---|---|
| CellRange.Comment 属性 | 拿到与单元格关联的批注对象。 |
| Comment 对象 | 表示一个 Excel 批注。 |
| Comment.Text 属性 | 拿到或设置批注中的文本内容。 |
| Comment.Height 属性 | 拿到或设置批注框的高度。 |
| Comment.Width 属性 | 拿到或设置批注框的宽度。 |
| Comment.AutoSize 属性 | 指示批注框大小是否会根据文本内容自动调整。 |
结合项目来看，本文后续示例将展示如何借助代码拿到 Excel 中已有的批注，并对其文本内容和格式进行修改。
以下是借助代码编辑 Excel 批注的基本步骤：
- 新建一个工作簿对象（Workbook）。
- 加载 Excel 文件。
- 拿到工作簿中的目标工作表。
- 拿到指定单元格中的已有批注。
- 修改批注内容，同时根据需调整批注框的高度、宽度或启用自动调整大小。
- 将修改后的文件保存为新的 Excel 文件。
结合项目来看，借助以上步骤，能够在程序中读取 Excel 文件，同时对已有批注进行编辑和格式调整。
完整示例如下所示：
using Spire.Xls;
namespace EditExcelComment
{
class Program
{
static void Main(string[] args)
{
// 创建一个 Workbook 实例
Workbook workbook = new Workbook();
// 加载 Excel 文件
workbook.LoadFromFile("Comments.xlsx");
// 获取第一个工作表
Worksheet sheet = workbook.Worksheets[0];
// 获取指定单元格中的批注并修改批注内容
sheet.Range["A8"].Comment.Text = "Frank has left the company.";
sheet.Range["F6"].Comment.Text = "Best sales.";
// 设置批注框的高度和宽度
sheet.Range["A8"].Comment.Height = 50;
sheet.Range["A8"].Comment.Width = 100;
sheet.Range["F6"].Comment.AutoSize = true;
// 保存文件
workbook.SaveToFile("ModifyComment.xlsx", ExcelVersion.Version2013);
}
}
}
删除 Excel 中的批注
借助代码删除 Excel 中指定批注的步骤如下所示：
- 新建一个工作簿对象（Workbook）。
- 加载 Excel 文件。
- 拿到工作簿中的目标工作表。
- 拿到指定单元格中的批注对象，并调用删除方法移除该批注。
- 将修改后的文档保存为新的 Excel 文件。
实际处理时，借助以上步骤，能够在程序中读取 Excel 文件，同时删除工作表中不需的批注。
完整示例如下所示：
using Spire.Xls;
namespace EditExcelComment
{
class Program
{
static void Main(string[] args)
{
// 创建一个 Workbook 实例
Workbook workbook = new Workbook();
// 加载 Excel 文件
workbook.LoadFromFile("Comments.xlsx");
// 获取第一个工作表
Worksheet sheet = workbook.Worksheets[0];
// 获取指定单元格中的批注并删除
sheet.Range["F6"].Comment.Remove();
// 保存文件
workbook.SaveToFile("DeleteComment.xlsx", ExcelVersion.Version2013);
}
}
}
知识扩展
在 C# 中操作 Excel 批注，主要有两种技术路线：采用第三方库（建议）或采用 COM 互操作。第三方库性能更好、无需安装 Excel，是开发中的首选。
下面为你详细说明几种主流方法。
准备工作：理解“批注”与“注释”
在开始前需留意，从 Excel 365 开始，微软对功能进行了更名：
- 批注 (Comments)：现在指代能够进行对话式回复的新式批注。
- 注释 (Notes)：指传统的、仅用来备注的旧式批注。
大多数 .NET 库（如 EPPlus）目前主要兼容操作传统的“注释 (Notes)”实际处理时，。这意味着，如果你的 Excel 文件里是那种带回复功能的新式批注，这些库可能无法直接读取或修改。
方法一：采用 EPPlus（开源、免费、建议）
EPPlus 是操作 .xlsx 文件的强大开源库，需借助 NuGet 安装，同时且需设置许可证上下文。
1. 编辑批注（注释）
using OfficeOpenXml;
using System.IO;
// 设置许可证上下文（非商业用途）
ExcelPackage.License.SetNonCommercialPersonal("你的名字");
using (var package = new ExcelPackage(new FileInfo("你的文件.xlsx")))
{
var worksheet = package.Workbook.Worksheets[0]; // 获取第一个工作表
// 获取 A1 单元格的批注
var comment = worksheet.Cells["A1"].Comment;
if (comment != null)
{
// 修改批注的纯文本内容
comment.Text = "这是修改后的批注内容。";
// 或者修改富文本内容（例如更改颜色）
// comment.RichText[0].Color = System.Drawing.Color.Red;
}
package.Save(); // 保存更改
}
- 核心：借助
worksheet.Cells["A1"].Comment拿到批注对象，随后修改其Text或RichText属性。 - 富文本：EPPlus 兼容富文本，能够单独设置文本中不同部分的字体、颜色、大小等。
2. 删除批注（注释）
using OfficeOpenXml;
using System.IO;
using (var package = new ExcelPackage(new FileInfo("你的文件.xlsx")))
{
var worksheet = package.Workbook.Worksheets[0];
// 删除 A1 单元格的批注
var commentToDelete = worksheet.Cells["A1"].Comment;
if (commentToDelete != null)
{
worksheet.Comments.Remove(commentToDelete);
}
// 或者直接通过单元格地址删除
// worksheet.Comments.Remove(worksheet.Comments["A1"]);
package.Save();
}
核心：借助 worksheet.Comments.Remove() 方法传入要删除的批注对象。
小提示：采用 worksheet.Comments 集合能够遍历工作表中的所有批注。
方法二：采用 Spire.XLS（功能丰富，商业库）
理解这一步时，Spire.XLS 是一款功能全面的商业库，对新式“批注”的兼容可能更好。
1. 编辑批注
using Spire.Xls;
Workbook workbook = new Workbook();
workbook.LoadFromFile("你的文件.xlsx");
Worksheet sheet = workbook.Worksheets[0];
// 修改 A8 单元格的批注文本
sheet.Range["A8"].Comment.Text = "这是修改后的文本。";
// 调整批注框的大小
sheet.Range["A8"].Comment.Height = 50;
sheet.Range["A8"].Comment.Width = 100;
workbook.SaveToFile("修改后的文件.xlsx", ExcelVersion.Version2013);
核心：直接借助 Range.Comment 属性访问同时修改。
2. 删除批注
using Spire.Xls;
Workbook workbook = new Workbook();
workbook.LoadFromFile("你的文件.xlsx");
Worksheet sheet = workbook.Worksheets[0];
// 删除 A1 单元格的批注
sheet.Range["A1"].Comment.Delete();
workbook.SaveToFile("删除批注后的文件.xlsx", ExcelVersion.Version2013);
核心：调用 Comment.Delete() 方法。
方法三：采用 COM 互操作（不建议，仅作为备选）
此方法直接操作 Excel 应用程序，速度慢、不稳定，且要求运行环境必须安装 Excel。
1. 编辑批注
using Microsoft.Office.Interop.Excel;
Application excelApp = new Application();
Workbook workbook = excelApp.Workbooks.Open("你的文件.xlsx");
Worksheet worksheet = workbook.Worksheets[1]; // COM 中索引从1开始
Range rng = worksheet.Range["A1"];
if (rng.Comment != null)
{
// 修改批注文本
rng.Comment.Text("这是修改后的文本。");
}
workbook.Save();
workbook.Close();
excelApp.Quit();
核心：借助 Range.Comment 对象操作，修改文本采用 Text() 方法。
2. 删除批注
using Microsoft.Office.Interop.Excel;
Application excelApp = new Application();
Workbook workbook = excelApp.Workbooks.Open("你的文件.xlsx");
Worksheet worksheet = workbook.Worksheets[1];
Range rng = worksheet.Range["A1"];
if (rng.Comment != null)
{
rng.Comment.Delete(); // 删除批注
}
workbook.Save();
workbook.Close();
excelApp.Quit();
- 核心：调用
Comment.Delete()方法。 - 注意：务必正确处理 COM 对象的释放，否则会导致内存泄漏。
总结
结合项目来看，Excel 批注能够帮助用户在工作表中添加额外说明、记录信息或与其他协作者进行沟通。在实际采用过程中，除了添加批注外，还可能需根据需求对已有批注进行修改或删除。
理解这一步时，本文主要讲解了如何借助编程方式处理 Excel 批注，包括编辑批注内容、调整批注大小以及删除指定批注。借助加载 Excel 文件、定位目标工作表和单元格，再对批注对象进行相应操作，能够更快完成批注管理任务。
从实现思路看，无论是更新已有备注，还是清理不再需的批注，这种自动化处理方式都适用来需批量处理 Excel 文件的场景，能够减少手动操作，提高工作效率。
结合项目来看，总的来说，C#编辑Excel批注适合结合实际项目边做边理解。先抓住核心思路，再逐步补上细节和边界处理，最后效果会更稳定，也更容易复用。