Добавить комментарии на лист Excel C#

Комментарии на листах Excel используются для добавления дополнительной информации или объяснения формулы. Эти комментарии также можно отформатировать, указав размер шрифта, высоту, ширину и т. д. В этой статье вы узнаете, как добавлять комментарии к листам Excel с помощью C#. Кроме того, в статье также будет продемонстрировано, как программно применять форматирование и добавлять изображения к комментариям.

C# API для добавления комментариев в Excel

Чтобы добавлять комментарии в рабочие листы Excel, мы будем использовать Aspose.Cells для .NET. Это мощный API для работы с электронными таблицами, который позволяет создавать файлы Excel с нуля. Кроме того, он поддерживает беспрепятственное изменение и преобразование существующих файлов Excel. Вы можете либо скачать API, либо установить его с помощью NuGet.

PM> Install-Package Aspose.Cells

Добавление комментариев к рабочему листу Excel в C#

Ниже приведены шаги по добавлению комментариев на лист Excel в C#.

  • Загрузите файл Excel, используя класс Workbook.
  • Получить ссылку на нужный Worksheet из коллекции Workbook.Worksheets.
  • Добавьте комментарий к рабочему листу с помощью метода Worksheet.Comments.Add(string) и получите ссылку на комментарий в объекте Comment.
  • Установите примечание к комментарию с помощью свойства Comment.Note.
  • Сохраните обновленный файл Excel, используя метод Workbook.Save(string).

В следующем примере кода показано, как добавить комментарий на лист Excel с помощью C#.

// Создание экземпляра объекта Workbook
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");

Добавить изображение в комментарий в Excel с помощью С#

Вы также можете добавить изображение к комментарию на листе Excel, выполнив следующие действия.

  • Загрузите файл Excel, используя класс Workbook.
  • Получите ссылку на CommentCollection на нужном листе, используя свойство Workbook.Worksheets[index].Comments.
  • Добавьте новый комментарий в коллекцию и получите ссылку на него в объекте Comment.
  • Установите примечание к комментарию с помощью свойства Comment.Note.
  • Загрузите изображение из файла в объект Bitmap.
  • Сохраните растровое изображение в объекте MemoryStream.
  • Добавьте изображение к комментарию, используя свойство Comment.CommentShape.Fill.ImageData.
  • Сохраните обновленный файл Excel, используя метод Workbook.Save(string).

В следующем примере кода показано, как добавить изображение в комментарий в Excel с помощью C#.

// Создание экземпляра объекта Workbook
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");

Применение форматирования к комментариям в Excel с помощью C#

Ниже приведены шаги по применению форматирования к комментариям в Excel с помощью C#.

  • Загрузите файл Excel, используя класс Workbook.
  • Получить ссылку на нужный Worksheet из коллекции Workbook.Worksheets.
  • Добавьте комментарий к рабочему листу с помощью метода Worksheet.Comments.Add(string) и получите ссылку на комментарий в объекте Comment.
  • Установите примечание к комментарию с помощью свойства Comment.Note.
  • Установите желаемые параметры форматирования комментария.
  • Сохраните обновленный файл Excel, используя метод Workbook.Save(string).

В следующем примере кода показано, как настроить форматирование комментариев в Excel с помощью C#.

// Создание экземпляра объекта Workbook
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 для .NET без ограничений по ознакомительной версии, используя временную лицензию.

Вывод

В этой статье вы узнали, как добавлять комментарии к листам Excel с помощью C#. Кроме того, вы видели, как добавить изображение к комментарию программно. Вы можете легко интегрировать предоставленный код в свои приложения на основе .NET, .NET Core или Xamarin. Кроме того, вы можете изучить документацию Aspose.Cells для .NET. Если у вас возникнут какие-либо вопросы, пишите на наш форум.

Смотрите также