Додайте коментарі на аркуші Excel C#

Коментарі в робочих аркушах Excel використовуються для додавання додаткової інформації або пояснення формули. Ці коментарі також можна відформатувати, визначивши розмір шрифту, висоту, ширину тощо. У цій статті ви дізнаєтеся, як додавати коментарі до робочих аркушів Excel за допомогою C#. Крім того, у статті також буде показано, як застосувати форматування та додати зображення до коментарів програмним шляхом.

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

Щоб додати коментарі до робочих аркушів Excel, ми будемо використовувати Aspose.Cells for .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 за допомогою C#

Ви також можете додати зображення до коментаря на аркуші Excel, виконавши наведені нижче дії.

  • Завантажте файл Excel за допомогою класу Workbook.
  • Отримайте посилання на CommentCollection на потрібному аркуші за допомогою властивості Workbook.Worksheets[index].Comments.
  • Додайте новий коментар до колекції та отримайте посилання на нього в об’єкті Comment.
  • Встановіть примітку до коментаря за допомогою властивості Comment.Note.
  • Завантажте зображення з файлу в об’єкт Bitmap.
  • Збережіть 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 for .NET без оціночних обмежень за допомогою тимчасової ліцензії.

Висновок

У цій статті ви дізналися, як додавати коментарі до робочих аркушів Excel за допомогою C#. Крім того, ви бачили, як програмно додати зображення до коментаря. Ви можете легко інтегрувати наданий код у свої програми на основі .NET, .NET Core або Xamarin. Крім того, ви можете ознайомитися з документацією Aspose.Cells for .NET. Якщо у вас виникнуть запитання, надішліть допис на нашому форумі.

Дивись також