Excel 批注功能非常实用，就像给单元格贴上一张便利贴，可用于补充说明、记录备注或与同事交流。添加批注后，您可以随时调整格式、编辑内容、设置显示或隐藏，甚至直接删除。
本文将详细介绍如何使用编程方式，在 .NET 环境中对 Excel 工作表中的批注进行修改或删除操作。直接上代码，简明扼要。
安装所需组件
开始前，需要将必要的 DLL 文件添加到 .NET 项目中。您可以手动下载文件并引用，或通过 NuGet 包管理器一键安装，更加便捷高效。安装完成后，即可在代码中调用相关功能处理 Excel 文件。
PM> Install-Package Spire.XLS
编辑 Excel 中的批注
实际工作中，批注内容常常需要更新，例如调整措辞、修改批注框大小，或让框自动适应文本。下表列出了常用的类和属性，通过这些可以获取已有批注，并设置新的文本和格式。
| 名称 | 描述 |
|---|---|
| CellRange.Comment 属性 | 获取与单元格关联的批注对象。 |
| Comment 对象 | 表示一个 Excel 批注。 |
| Comment.Text 属性 | 获取或设置批注中的文本内容。 |
| Comment.Height 属性 | 获取或设置批注框的高度。 |
| Comment.Width 属性 | 获取或设置批注框的宽度。 |
| Comment.AutoSize 属性 | 指示批注框大小是否根据文本内容自动调整。 |
下方的示例将演示如何获取已有批注，并修改文本和调整格式。核心步骤如下：
- 创建一个工作簿对象（Workbook）。
- 加载 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.Sa veToFile("ModifyComment.xlsx", ExcelVersion.Version2013);
}
}
}
删除 Excel 中的批注
删除批注的流程与编辑类似，只需最后一步调用删除方法。具体步骤：
- 创建 Workbook 并加载文件。
- 获取目标工作表。
- 拿到指定单元格的批注对象，然后调用删除方法。
- 保存为新文件。
代码示例：
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.Sa veToFile("DeleteComment.xlsx", ExcelVersion.Version2013);
}
}
}
知识扩展
使用 C# 操作 Excel 批注，主要有两种途径：借助第三方库（推荐）或 COM 互操作。第三方库性能更优，且无需安装 Excel，是开发中的首选方案。
下面详细介绍几种主流方法。
先区分“批注”和“注释”
从 Excel 365 开始，微软对命名做了调整：
- 批注 (Comments)：指带有回复功能的新式批注。
- 注释 (Notes)：指传统、仅用于备注的旧式批注。
大多数 .NET 库（如 EPPlus）目前主要支持操作传统的“注释 (Notes)”。也就是说，如果 Excel 文件使用了带回复功能的新式批注，这些库可能无法读取或修改。
方法一：使用 EPPlus（开源、免费、推荐）
EPPlus 是处理 .xlsx 文件的强大开源库，需通过 NuGet 安装，并设置许可证上下文。
编辑批注（注释）：
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.Sa ve(); // 保存更改
}
核心是通过 worksheet.Cells["A1"].Comment 获取批注对象，然后修改其 Text 或 RichText 属性。EPPlus 支持富文本，可单独设置字体、颜色、字号等。
删除批注（注释）：
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.Sa ve();
}
核心是通过 worksheet.Comments.Remove() 方法传入要删除的批注对象。使用 worksheet.Comments 集合还可遍历所有批注。
方法二：使用 Spire.XLS（功能丰富，商业库）
Spire.XLS 是功能全面的商业库，对新式“批注”的支持可能更好。
编辑批注：
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.Sa veToFile("修改后的文件.xlsx", ExcelVersion.Version2013);
核心是通过 Range.Comment 属性直接访问并修改。
删除批注：
using Spire.Xls;
Workbook workbook = new Workbook();
workbook.LoadFromFile("你的文件.xlsx");
Worksheet sheet = workbook.Worksheets[0];
// 删除 A1 单元格的批注
sheet.Range["A1"].Comment.Delete();
workbook.Sa veToFile("删除批注后的文件.xlsx", ExcelVersion.Version2013);
核心是调用 Comment.Delete() 方法。
方法三：使用 COM 互操作（不推荐，仅作为备选）
此方法直接操作 Excel 应用程序，速度慢、不稳定，且运行环境必须安装 Excel。
编辑批注：
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.Sa ve();
workbook.Close();
excelApp.Quit();
核心是通过 Range.Comment 对象操作，修改文本使用 Text() 方法。
删除批注：
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.Sa ve();
workbook.Close();
excelApp.Quit();
核心是调用 Comment.Delete() 方法。特别注意：COM 对象必须妥善释放，否则容易导致内存泄漏。
总结
Excel 批注在日常办公中非常常见，可用于添加备注、记录信息或与同事沟通。除了添加批注，有时也需要修改或删除已有的批注。
本文介绍了如何使用代码处理批注，包括编辑内容、调整大小以及删除指定批注。整体流程为：加载 Excel 文件、定位目标工作表和单元格、对批注对象执行相应操作，从而快速完成批注管理。
无论是更新备注内容，还是清理不需要的批注，这种自动化处理方式都非常适合需要批量操作 Excel 文件的场景，能够大幅减少手动操作时间，显著提升工作效率。
