首页 > 编程语言 >C#实现Excel批注编辑与删除

C#实现Excel批注编辑与删除

来源：互联网 2026-07-24 08:32:06

Excel资讯合集

在.NET环境中使用C#可通过Spire.XLS、EPPlus等库编辑或删除Excel批注。核心步骤包括加载工作簿、定位工作表及单元格、获取批注对象后修改文本或调用删除方法，最后保存文件。该方法支持批量处理，提升效率。

Excel 批注就像给单元格贴上一张便利贴，用于补充说明、记录备注或与同事沟通。添加后，可以随时调整格式、编辑内容、显示或隐藏，甚至直接删除。

C#实现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 对象的释放需妥善处理，否则易导致内存泄漏。