Excel 工作表中的注释用于添加附加信息或解释公式。这些注释也可以通过定义字体大小、高度、宽度等进行格式化。在本文中,您将学习如何使用 C# 向 Excel 工作表添加注释。此外,本文还将演示如何以编程方式应用格式并将图像添加到评论中。
在 Excel 中添加注释的 C# API
为了在 Excel 工作表中添加注释,我们将使用 Aspose.Cells for .NET。它是一个强大的电子表格操作 API,可让您从头开始创建 Excel 文件。此外,它还支持无缝修改和转换现有的 Excel 文件。您可以 下载 API 或使用 NuGet 安装它。
PM> Install-Package Aspose.Cells
在 C# 中向 Excel 工作表添加注释
以下是在 C# 中向 Excel 工作表添加注释的步骤。
- 使用 Workbook 类加载 Excel 文件。
- 从 Workbook.Worksheets 集合中获取所需 Worksheet 的参考。
- 使用 Worksheet.Comments.Add(string) 方法向工作表添加注释,并在 Comment 对象中获取注释的引用。
- 使用 Comment.Note 属性设置评论的注释。
- 使用 Workbook.Save(string) 方法保存更新的 Excel 文件。
以下代码示例演示如何使用 C# 在 Excel 工作表中添加注释。
// 实例化工作簿对象
Workbook workbook = new Workbook("workbook.xlsx");
// 通过传递其工作表索引来获取第一个工作表的引用
Worksheet worksheet = workbook.Worksheets[0];
// 向“F5”单元格添加评论
int commentIndex = worksheet.Comments.Add("F5");
// 访问新添加的评论
Comment comment = worksheet.Comments[commentIndex];
// 设置注释注释
comment.Note = "Hello Aspose!";
// 保存 Excel 文件
workbook.Save("output.xlsx");
使用 C# 将图像添加到 Excel 中的注释
您还可以按照以下步骤将图像添加到 Excel 工作表中的注释。
- 使用 Workbook 类加载 Excel 文件。
- 使用 Workbook.Worksheets[index].Comments 属性在所需工作表中获取 CommentCollection 的引用。
- 向集合添加新评论并在 Comment 对象中获取其引用。
- 使用 Comment.Note 属性设置评论的注释。
- 将文件中的图像加载到 Bitmap 对象中。
- 将位图保存到 MemoryStream 对象中。
- 使用 Comment.CommentShape.Fill.ImageData 属性将图像添加到评论。
- 使用 Workbook.Save(string) 方法保存更新的 Excel 文件。
以下代码示例展示了如何使用 C# 将图像添加到 Excel 中的注释。
// 实例化工作簿对象
Workbook workbook = new Workbook("workbook.xlsx");
// 使用第一张表获取评论集合的参考
CommentCollection comments = workbook.Worksheets[0].Comments;
// 向单元格 A1 添加注释
int commentIndex = comments.Add(0, 0);
Comment comment = comments[commentIndex];
comment.Note = "First note.";
comment.Font.Name = "Times New Roman";
// 将图像加载到流中
Bitmap bmp = new Bitmap("logo.jpg");
MemoryStream ms = new MemoryStream();
bmp.Save(ms, System.Drawing.Imaging.ImageFormat.Png);
// 将图像数据设置为与评论关联的形状
comment.CommentShape.Fill.ImageData = ms.ToArray();
// 保存工作簿
workbook.Save("book1.xlsx");
使用 C# 将格式应用于 Excel 中的注释
以下是使用 C# 将格式应用于 Excel 中的注释的步骤。
- 使用 Workbook 类加载 Excel 文件。
- 从 Workbook.Worksheets 集合中获取所需 Worksheet 的参考。
- 使用 Worksheet.Comments.Add(string) 方法向工作表添加注释,并在 Comment 对象中获取注释的引用。
- 使用 Comment.Note 属性设置评论的注释。
- 设置所需的注释格式选项。
- 使用 Workbook.Save(string) 方法保存更新的 Excel 文件。
以下代码示例展示了如何使用 C# 在 Excel 中设置注释的格式。
// 实例化工作簿对象
Workbook workbook = new Workbook("workbook.xlsx");
// 通过传递其工作表索引来获取第一个工作表的引用
Worksheet worksheet = workbook.Worksheets[0];
// 向“F5”单元格添加注释
int commentIndex = worksheet.Comments.Add("F5");
// 访问新添加的评论
Comment comment = worksheet.Comments[commentIndex];
// 设置注释注释
comment.Note = "Hello Aspose!";
// 将评论的字体大小设置为 14
comment.Font.Size = 14;
// 将评论的字体设置为粗体
comment.Font.IsBold = true;
// 将字体高度设置为 10
comment.HeightCM = 10;
// 将字体宽度设置为 2
comment.WidthCM = 2;
// 保存 Excel 文件
workbook.Save("output.xlsx");
获得免费许可证
您可以使用 临时许可证 使用 Aspose.Cells for .NET,而不受评估限制。
结论
在本文中,您学习了如何使用 C# 向 Excel 工作表添加注释。此外,您还了解了如何以编程方式将图像添加到评论中。您可以轻松地将提供的代码集成到基于 .NET、.NET Core 或 Xamarin 的应用程序中。此外,您可以浏览 Aspose.Cells for .NET 的 文档。如果您有任何疑问,请随时在我们的 论坛 上发帖。