C#教程

关注公众号 jb51net

关闭
首页 > 软件编程 > C#教程 > C#编辑或删除Excel批注

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

作者：2501_93070778

本文将教你用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 批注的基本步骤：

  1. 创建一个工作簿对象（Workbook）。
  2. 加载 Excel 文件。
  3. 获取工作簿中的目标工作表。
  4. 获取指定单元格中的已有批注。
  5. 修改批注内容，并根据需要调整批注框的高度、宽度或启用自动调整大小。
  6. 将修改后的文件保存为新的 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 中指定批注的步骤如下：

  1. 创建一个工作簿对象（Workbook）。
  2. 加载 Excel 文件。
  3. 获取工作簿中的目标工作表。
  4. 获取指定单元格中的批注对象，并调用删除方法移除该批注。
  5. 将修改后的文档保存为新的 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 开始，微软对功能进行了更名：

大多数 .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(); // 保存更改
}

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();

总结

Excel 批注可以帮助用户在工作表中添加额外说明、记录信息或与其他协作者进行沟通。在实际使用过程中，除了添加批注外，还可能需要根据需求对已有批注进行修改或删除。

本文介绍了如何通过编程方式处理 Excel 批注，包括编辑批注内容、调整批注大小以及删除指定批注。通过加载 Excel 文件、定位目标工作表和单元格，再对批注对象进行相应操作，可以快速完成批注管理任务。

无论是更新已有备注，还是清理不再需要的批注，这种自动化处理方式都适用于需要批量处理 Excel 文件的场景，能够减少手动操作，提高工作效率。

以上就是C#代码实现在Excel中编辑或删除批注的详细内容，更多关于C#编辑或删除Excel批注的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:
阅读全文