如何在.NET中通过Spire.XLS为Excel指定工作表所有单元格添加Tooltip？

前提准备 #

确保已通过NuGet安装Spire.XLS组件：

• .NET Framework：执行Install-Package Spire.XLS
• .NET Core/.NET 5+：执行dotnet add package Spire.XLS

完整代码示例 #

using Spire.Xls;

class ExcelTooltipHelper
{
    static void Main(string[] args)
    {
        // 加载目标Excel文件
        Workbook workbook = new Workbook();
        workbook.LoadFromFile("SourceFile.xlsx");

        // 获取指定工作表（此处示例取第一个工作表，索引从0开始）
        Worksheet targetSheet = workbook.Worksheets[0];

        // 获取工作表中已使用的单元格范围，避免遍历空单元格
        CellRange usedCells = targetSheet.AllocatedRange;

        // 遍历每个单元格添加Tooltip（即Excel批注）
        foreach (CellRange cell in usedCells)
        {
            // 为单元格添加批注
            CellComment tooltip = cell.AddComment();
            // 自定义Tooltip内容，可根据需求修改
            tooltip.Text = $"单元格{cell.Address}：{cell.Value ?? "空值"}";
            
            // 配置Tooltip显示逻辑：默认隐藏，鼠标悬停时自动显示
            tooltip.Visible = false;
            // 可选：设置Tooltip弹窗的大小
            tooltip.Height = 70;
            tooltip.Width = 140;
        }

        // 保存修改后的文件
        workbook.SaveToFile("ResultWithTooltips.xlsx", ExcelVersion.Version2016);
        workbook.Dispose();
    }
}

关键说明 #

• 这里的Tooltip对应Excel的单元格批注，鼠标悬停时自动显示
• 若只需给特定范围单元格添加Tooltip，可将usedCells替换为指定范围，比如targetSheet.Range["A1:D20"]
• 如果之前的方案无效，检查是否引用了正确版本的Spire.XLS，或是否错误遍历了空单元格范围
• 如需更复杂的Tooltip样式（如字体、背景色），可通过tooltip.Style属性配置，例如tooltip.Style.Font.Name = "微软雅黑"

内容的提问来源于stack exchange，提问作者Jitendra Singh