C#代码实现隐藏或显示Excel中的批注

Excel 里的批注，说白了就是贴在单元格上的“便利贴”，用来给数据加点备注、说明，或者做点小提醒。当数据量越来越大、批注越积越多，工作表难免变得有点乱，甚至还会遮挡住关键内容。这时候，把批注暂时藏起来，能让界面清爽不少；等需要查阅说明时，再一键显示出来，又很方便。

今天这篇文章，就聊聊怎么用 C# 来动态控制 Excel 批注的隐藏和显示。整个过程并不复杂，核心就两个动作：读文件、改属性。

安装所需库

动手之前，先搞定环境。在 .NET 项目里添加 Excel 处理库，建议直接用 NuGet 包管理器，一条命令搞定，简单省事。

PM> Install-Package Spire.XLS

在 Excel 中隐藏批注

隐藏批注的操作，本质上就是把批注对象的可见性属性设为 false。可以通过索引定位到具体某个批注，也可以遍历所有批注批量隐藏。

具体走一遍流程：

1. 创建一个 Workbook 实例。
2. 用 Workbook.LoadFromFile() 加载 Excel 文件。
3. 通过 Workbook.Worksheets[] 拿到想要操作的工作表。
4. 将目标批注的 IsVisible 属性设为 false。
5. 保存文件，结束。

完整示例代码如下：

using Spire.Xls;

namespace ShowExcelComments
{
    class Program
    {
        static void Main(string[] args)
        {
            // 创建 Workbook 对象并加载 Excel 文件
            Workbook workbook = new Workbook();
            workbook.LoadFromFile("Comments.xlsx");

            // 获取第一个工作表
            Worksheet sheet = workbook.Worksheets[0];

            // 隐藏工作表中的指定批注
            sheet.Comments[0].IsVisible = false;

            // 保存结果文件
            workbook.Sa veToFile("HideComment.xlsx", ExcelVersion.Version2013);
            workbook.Dispose();
        }
    }
}

在 Excel 中显示批注

显示批注就更简单了——把可见性改回 true 就行。和隐藏的操作几乎一模一样，只是把 IsVisible 从 false 换成 true。

来看代码：

using Spire.Xls;

namespace ShowExcelComments
{
    class Program
    {
        static void Main(string[] args)
        {
            // 创建 Workbook 对象并加载 Excel 文件
            Workbook workbook = new Workbook();
            workbook.LoadFromFile("HideComment.xlsx");

            // 获取第一个工作表
            Worksheet sheet = workbook.Worksheets[0];

            // 显示工作表中的指定批注
            sheet.Comments[0].IsVisible = true;

            // 保存结果文件
            workbook.Sa veToFile("ShowComment.xlsx", ExcelVersion.Version2013);
            workbook.Dispose();
        }
    }
}

知识扩展

控制批注的可见性，万变不离其宗——找到正确的批注对象，然后改它的 IsVisible 或 Visible 属性。市面上主流 .NET 组件都支持这个操作，只是 API 细节略有不同。下面把几种常见方案都梳理一遍，方便你在不同项目里灵活选用。

使用 Spire.XLS（功能全面，API 直观）

using Spire.Xls;
// 1. 实例化 Workbook 并加载文件
Workbook workbook = new Workbook();
workbook.LoadFromFile("Comments.xlsx");
// 2. 获取第一个工作表
Worksheet sheet = workbook.Worksheets[0];
// 3. 隐藏特定批注（例如第一个批注）
sheet.Comments[0].IsVisible = false;
// 设置 sheet.Comments[0].IsVisible = true; 即可显示该批注
// 4. 隐藏或显示所有批注
foreach (ExcelComment comment in sheet.Comments)
{
    comment.IsVisible = true; // 设置为 false 则隐藏
}
// 5. 保存文件
workbook.Sa veToFile("Result.xlsx", ExcelVersion.Version2013);

这种方法通过 Comments 集合索引或遍历就可以轻松搞定，关键就是那行 IsVisible 赋值。

// 查找并控制特定单元格的批注可见性
CellRange specificCell = sheet.Range["B5"];
if (specificCell.HasComment)
{
    specificCell.Comment.IsVisible = true; // 或 false
}

使用 Aspose.Cells（功能强大，适合复杂操作）

using Aspose.Cells;
// 1. 加载工作簿
Workbook workbook = new Workbook("Comments.xlsx");
// 2. 获取第一个工作表
Worksheet worksheet = workbook.Worksheets[0];
// 3. 访问指定单元格的批注并设置可见性
Cell cell = worksheet.Cells["B5"];
if (cell.HasComment)
{
    cell.Comment.IsVisible = true;
    // cell.Comment.IsVisible = false;
}

Aspose.Cells 也为批量操作提供了类似方法，原理完全一样。

使用 GemBox.Spreadsheet（轻量级，许可灵活）

using GemBox.Spreadsheet;
// 加载文件
SpreadsheetInfo.SetLicense("FREE-LIMITED-KEY"); 
var workbook = ExcelFile.Load("Comments.xlsx");
var worksheet = workbook.Worksheets[0];
// 获取批注对象并设置可见性
ExcelComment comment = worksheet.Cells["B5"].Comment;
comment.IsVisible = true; // 或 false

核心还是 comment.IsVisible 属性。

使用 GrapeCity Documents for Excel（GcExcel，高性能）

using GrapeCity.Documents.Excel;
// 1. 创建工作簿并加载文件
Workbook workbook = new Workbook();
workbook.Open("Comments.xlsx");
// 2. 获取第一个工作表
IWorksheet worksheet = workbook.Worksheets[0];
// 3. 设置批注可见性
IComment comment = worksheet.Range["B5"].Comment;
comment.Visible = true; // 或 false

这里属性名变成了 Visible，本质一样。

使用 NPOI（开源、免费，但需手动处理索引）

using NPOI.XSSF.UserModel;
using NPOI.SS.UserModel;
// 1. 加载工作簿
XSSFWorkbook workbook = null;
using (FileStream file = new FileStream("Comments.xlsx", FileMode.Open, FileAccess.Read))
{
    workbook = new XSSFWorkbook(file);
}
// 2. 获取第一个工作表
ISheet sheet = workbook.GetSheetAt(0);
// 3. 遍历所有行和单元格查找并修改批注
for (int rowIndex = 0; rowIndex <= sheet.LastRowNum; rowIndex++)
{
    IRow row = sheet.GetRow(rowIndex);
    if (row != null)
    {
        for (int cellIndex = 0; cellIndex < row.LastCellNum; cellIndex++)
        {
            ICell cell = row.GetCell(cellIndex);
            if (cell != null && cell.CellComment != null)
            {
                // 注意：NPOI 主要通过替换文本模拟显示/隐藏，
                // 此处演示如何访问批注对象
                var comment = cell.CellComment;
                comment.String = new XSSFRichTextString(comment.String.String); 
                // 或者考虑删除批注再重新添加来模拟显示/隐藏
            }
        }
    }
}
// 4. 保存文件
using (FileStream file = new FileStream("Result.xlsx", FileMode.Create))
{
    workbook.Write(file);
}

NPOI 获取批注直接通过 cell.CellComment，核心也是修改 Visible 属性（不过部分版本需要绕个弯）。总的来说，只要找到批注对象，就能控制它的显示状态。

总结

这篇文章介绍了如何用 C# 在 Excel 工作表中隐藏和显示批注。操作很直接：修改批注对象的 IsVisible 或 Visible 属性，设为 false 隐藏，设为 true 显示。通过这种方式，开发者完全可以根据实际业务需求动态管理批注的显示效果——既不影响数据查阅，又能保持界面的整洁和美观。

以上就是从多个常用组件的角度，对批注可见性控制的一次完整梳理。掌握了这个思路，不管换哪个库都能快速上手，这才是关键所在。