C#代码实现在Excel中编辑或删除批注

Excel 批注是个好东西，相当于给单元格贴了个便利贴，用来补充说明、写备注，或者跟同事打个招呼。添加之后，你可以随时调整格式、编辑内容、显示或隐藏，甚至直接删掉。

这篇文章就聊聊怎么用编程的方式，在 .NET 环境里把 Excel 工作表中的批注给改了或者删了。直接上代码，不废话。

安装所需组件

开始之前，先把必要的 DLL 文件加到 .NET 项目里。你可以直接下载文件手动引用，或者用 NuGet 包管理器一键安装，省心省力。装完之后，就能在代码里调用相关功能来处理 Excel 文件了。

PM> Install-Package Spire.XLS

编辑 Excel 中的批注

有时候，批注里的内容需要更新，比如调整一下措辞、改改框的大小，或者直接让它自动适应文本。下面这张表列出了一些常用的类和属性，通过这些就能拿到已有的批注，然后设置新的文本和格式。

后面的示例会演示怎么获取已有的批注，然后修改文本和调整格式。核心思路就几步：

1. 创建一个工作簿对象（Workbook）。
2. 加载 Excel 文件。
3. 获取目标工作表。
4. 拿到指定单元格的批注。
5. 修改内容，以及调整高度、宽度，或者开启自动大小。
6. 保存成一个新的 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 中的批注

删批注的逻辑跟编辑差不多，只是最后一步换成调用删除方法。具体步骤：

1. 创建 Workbook 并加载文件。
2. 获取目标工作表。
3. 拿到指定单元格的批注对象，然后调用删除方法。
4. 保存为新文件。

代码示例：

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 文件的场景，能省不少手动操作的时间，效率提升很明显。