C#代码实现方式在Excel中编辑或删除批注实用指南-45看点

平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“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批注适合结合实际项目边做边理解。先抓住核心思路，再逐步补上细节和边界处理，最后效果会更稳定，也更容易复用。