使用C#代码在 Excel 中添加或设置批注格式

在 Excel 中，批注用于解释单元格中的内容，或添加对读者有帮助的附加信息。使用 Spire.XLS for .NET，我们不仅可以轻松地为 Excel 单元格添加批注，还可以通过设置批注框大小或为批注文本应用字体样式来自定义其外观。本文将从以下两个部分演示如何使用 C#/VB.NET 以编程方式向 Excel 工作表添加批注。

安装 Spire.XLS for .NET

首先，您需要将 Spire.XLS for .NET 包中包含的 DLL 文件添加为 .NET 项目的引用。这些 DLL 文件可以通过下载获取，也可以通过 NuGet 进行安装。

PM> Install-Package Spire.XLS

在 Excel 工作表中添加批注

Spire.XLS 提供了 CellRange.AddComment() 方法，用于在 Excel 工作表中添加普通文本批注。具体步骤如下：

1. 初始化 Workbook 类的一个实例。
2. 使用 Workbook.LoadFromFile() 方法加载 Excel 文件。
3. 通过 Workbook.Worksheetsint 属性获取 Excel 文件中的第一个工作表。
4. 使用 CellRange.AddComment() 方法在指定单元格区域添加批注，并通过 ExcelComment 对象的 Text 属性设置批注内容。
5. 使用 Workbook.SaveToFile() 方法将文档保存为另一个文件。

示例代码如下：

using Spire.Xls;

namespace WordDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // 创建 Workbook 对象
            Workbook workbook = new Workbook();

            // 加载示例工作簿
            workbook.LoadFromFile("Sample.xlsx");

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

            // 在指定单元格区域 C6 添加普通批注
            CellRange range = sheet.Range["C6"];
            ExcelComment comment = range.AddComment();
            comment.Text = "普通批注";                      
            
            // 保存 Excel 工作簿
            workbook.SaveToFile("Addcomment.xlsx", ExcelVersion.Version2016);

        }
    }
}

在 Excel 工作表中为批注应用格式

Spire.XLS 提供了 Comment.RichText.SetFont() 方法，可用于为 Excel 工作表中的批注设置字体格式。

1. 初始化 Workbook 类的一个实例。
2. 使用 Workbook.LoadFromFile() 方法加载 Excel 文件。
3. 通过 Workbook.Worksheetsint 属性获取 Excel 文件中的第一个工作表。
4. 使用 CellRange.AddComment() 方法在指定单元格区域添加批注，并设置批注内容。
5. 创建一个 ExcelFont 对象，并使用 ExcelComment.RichText.SetFont() 方法将字体应用到批注文本。
6. 使用 Workbook.SaveToFile() 方法将文档保存为另一个文件。

示例代码如下：

using Spire.Xls;

namespace ExcelComment
{
    class Program
    {
        static void Main(string[] args)
        {
            // 创建 Workbook 对象
            Workbook workbook = new Workbook();

            // 加载示例工作簿
            workbook.LoadFromFile("Sample.xlsx");

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

            // 在指定单元格区域 C6 添加批注                                              
            CellRange range = sheet.Range["C6"];
            ExcelComment comment = range.AddComment();
            comment.Text = "带格式的批注";                      
            
            // 设置宽度和高度
            comment.Width = 100;
            comment.Height = 200;

            // 显示批注
            comment.Visible = true;

            // 创建字体
            ExcelFont font = workbook.CreateFont();
            font.FontName = "Calibri";
            font.Size = 14;
            font.KnownColor = ExcelColors.LightBlue;
            font.IsBold = true;

            // 将字体应用到批注文本
            comment.RichText.SetFont(0, 27, font);

            // 保存 Excel 工作簿
            workbook.SaveToFile("AddcommentwithFormat.xlsx", ExcelVersion.Version2016);

        }
    }
}

申请临时许可证

如果您希望去除生成文档中的评估提示信息，或解除功能限制，请为自己申请一个 30 天的试用许可证。