C#代碼實現(xiàn)隱藏或顯示Excel中的批注

更新時間：2026年06月02日 08:20:28 作者：2501_93070778

Excel?中的批注是一種附加在單元格上的文本說明,本文將為大家詳細介紹如何通過?C#?在?Excel?中隱藏或顯示批注,有需要的小伙伴可以了解下

不過，當(dāng)工作表中存在大量批注時，可能會影響界面的整潔度，甚至遮擋部分內(nèi)容。為了提升工作表的可讀性和視覺效果，可以根據(jù)需要隱藏現(xiàn)有批注，使數(shù)據(jù)展示更加清晰；在需要查看說明信息時，也可以隨時重新顯示這些批注。

本文將介紹如何通過 C# 在 Excel 中隱藏或顯示批注。

安裝所需庫

在開始之前，需要在 .NET 項目中添加相應(yīng)的 Excel 處理庫引用。您可以下載對應(yīng)的 DLL 文件并手動添加到項目中，也可以通過 NuGet 包管理器進行安裝。

PM> Install-Package Spire.XLS

在 Excel 中隱藏批注

通過 Excel 處理庫提供的批注可見性屬性，可以控制批注是否顯示。將該屬性設(shè)置為 false 后，即可隱藏現(xiàn)有批注。

以下是隱藏 Excel 批注的具體步驟：

創(chuàng)建一個 Workbook 實例。
使用 Workbook.LoadFromFile() 方法加載 Excel 文件。
通過 Workbook.Worksheets[] 獲取指定工作表。
將目標(biāo)批注的可見性屬性設(shè)置為 false，以隱藏該批注。
使用 Workbook.SaveToFile() 方法保存結(jié)果文件。

完整示例代碼如下：

using Spire.Xls;

namespace ShowExcelComments
{
    class Program
    {
        static void Main(string[] args)
        {
            // 創(chuàng)建 Workbook 對象并加載 Excel 文件
            Workbook workbook = new Workbook();
            workbook.LoadFromFile("Comments.xlsx");

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

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

            // 保存結(jié)果文件
            workbook.SaveToFile("HideComment.xlsx", ExcelVersion.Version2013);
            workbook.Dispose();
        }
    }
}

在 Excel 中顯示批注

當(dāng)需要查看批注內(nèi)容時，可以重新顯示已隱藏的批注。只需將批注的可見性屬性設(shè)置為 true，即可使其重新顯示。

以下是在 Excel 中顯示批注的具體步驟：

創(chuàng)建一個 Workbook 實例。
使用 Workbook.LoadFromFile() 方法加載 Excel 文件。
通過 Workbook.Worksheets[] 獲取指定工作表。
將目標(biāo)批注的可見性屬性設(shè)置為 true，以顯示該批注。
使用 Workbook.SaveToFile() 方法保存結(jié)果文件。

完整示例代碼如下：

using Spire.Xls;

namespace ShowExcelComments
{
    class Program
    {
        static void Main(string[] args)
        {
            // 創(chuàng)建 Workbook 對象并加載 Excel 文件
            Workbook workbook = new Workbook();
            workbook.LoadFromFile("HideComment.xlsx");

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

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

            // 保存結(jié)果文件
            workbook.SaveToFile("ShowComment.xlsx", ExcelVersion.Version2013);
            workbook.Dispose();
        }
    }
}

知識擴展

操作 Excel 批注的可見性，常規(guī)做法是通過 Visible 或 IsVisible 屬性來控制，關(guān)鍵點在于找到正確的批注對象。下面匯總了幾種主流 .NET 組件的方法。

使用 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;
// 設(shè)置 sheet.Comments[0].IsVisible = true; 即可顯示該批注
// 4. 隱藏或顯示所有批注
foreach (ExcelComment comment in sheet.Comments)
{
    comment.IsVisible = true; // 設(shè)置為 false 則隱藏
}
// 5. 保存文件
workbook.SaveToFile("Result.xlsx", ExcelVersion.Version2013);

這種方法通過 Comments 集合索引或遍歷即可輕松實現(xiàn)。

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

使用 Aspose.Cells（功能強大，適合復(fù)雜操作）

using Aspose.Cells;
// 1. 加載工作簿
Workbook workbook = new Workbook("Comments.xlsx");
// 2. 獲取第一個工作表
Worksheet worksheet = workbook.Worksheets[0];
// 3. 訪問指定單元格的批注并設(shè)置可見性
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];
// 獲取批注對象并設(shè)置可見性
ExcelComment comment = worksheet.Cells["B5"].Comment;
comment.IsVisible = true; // 或 false

核心在于 comment.IsVisible 屬性。

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

using GrapeCity.Documents.Excel;
// 1. 創(chuàng)建工作簿并加載文件
Workbook workbook = new Workbook();
workbook.Open("Comments.xlsx");
// 2. 獲取第一個工作表
IWorksheet worksheet = workbook.Worksheets[0];
// 3. 設(shè)置批注可見性
IComment comment = worksheet.Range["B5"].Comment;
comment.Visible = true; // 或 false

comment.Visible 是控制顯示的關(guān)鍵屬性。

使用 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 屬性的庫。