Adicionar comentários na planilha do Excel C#

Comentários em planilhas do Excel são usados para adicionar informações adicionais ou para explicar uma fórmula. Esses comentários também podem ser formatados definindo o tamanho da fonte, altura, largura etc. Neste artigo, você aprenderá como adicionar comentários às planilhas do Excel usando C#. Além disso, o artigo também demonstrará como aplicar formatação e adicionar imagens aos comentários de forma programática.

API C# para adicionar comentários no Excel

Para adicionar comentários em planilhas do Excel, usaremos Aspose.Cells for .NET. É uma poderosa API de manipulação de planilhas que permite criar arquivos do Excel do zero. Além disso, ele suporta a modificação e conversão de arquivos Excel existentes sem problemas. Você pode baixar a API ou instalá-la usando NuGet.

PM> Install-Package Aspose.Cells

Adicionar comentários a uma planilha do Excel em C#

A seguir estão as etapas para adicionar comentários a uma planilha do Excel em C#.

O exemplo de código a seguir mostra como adicionar um comentário em uma planilha do Excel usando C#.

// Instanciando um objeto Workbook
Workbook workbook = new Workbook("workbook.xlsx");

// Obtendo a referência da primeira planilha passando seu índice de planilha
Worksheet worksheet = workbook.Worksheets[0];

// Adicionando um comentário à célula "F5"
int commentIndex = worksheet.Comments.Add("F5");

// Acessando o comentário recém-adicionado
Comment comment = worksheet.Comments[commentIndex];

// Configurando a nota de comentário
comment.Note = "Hello Aspose!";

// Salvando o arquivo Excel
workbook.Save("output.xlsx");

Adicionar imagem a um comentário no Excel usando C#

Você também pode adicionar uma imagem ao comentário na planilha do Excel seguindo as etapas abaixo.

O exemplo de código a seguir mostra como adicionar imagem a um comentário no Excel usando C#.

// Instanciando um objeto Workbook
Workbook workbook = new Workbook("workbook.xlsx");

// Obtendo uma referência da coleção de comentários com a primeira folha
CommentCollection comments = workbook.Worksheets[0].Comments;

// Adicionando um comentário à célula A1
int commentIndex = comments.Add(0, 0);
Comment comment = comments[commentIndex];
comment.Note = "First note.";
comment.Font.Name = "Times New Roman";

// Carregando uma imagem no fluxo
Bitmap bmp = new Bitmap("logo.jpg");
MemoryStream ms = new MemoryStream();
bmp.Save(ms, System.Drawing.Imaging.ImageFormat.Png);

// Definindo dados de imagem para a forma associada ao comentário
comment.CommentShape.Fill.ImageData = ms.ToArray();

// Salvando a pasta de trabalho
workbook.Save("book1.xlsx");

Aplicar formatação a comentários no Excel usando C#

A seguir estão as etapas para aplicar a formatação aos comentários no Excel usando C#.

O exemplo de código a seguir mostra como definir a formatação dos comentários no Excel usando C#.

// Instanciando um objeto Workbook
Workbook workbook = new Workbook("workbook.xlsx");

// Obtendo a referência da primeira planilha passando seu índice de planilha
Worksheet worksheet = workbook.Worksheets[0];

// Adicionando um comentário à célula "F5"
int commentIndex = worksheet.Comments.Add("F5");

// Acessando o comentário recém-adicionado
Comment comment = worksheet.Comments[commentIndex];

// Configurando a nota de comentário
comment.Note = "Hello Aspose!";

// Configurando o tamanho da fonte de um comentário para 14
comment.Font.Size = 14;

// Definir a fonte de um comentário para negrito
comment.Font.IsBold = true;

// Configurando a altura da fonte para 10
comment.HeightCM = 10;

// Configurando a largura da fonte para 2
comment.WidthCM = 2;

// Salvando o arquivo Excel
workbook.Save("output.xlsx");

Obtenha uma licença gratuita

Você pode usar o Aspose.Cells para .NET sem limitações de avaliação usando uma licença temporária.

Conclusão

Neste artigo, você aprendeu como adicionar comentários a planilhas do Excel usando C#. Além disso, você viu como adicionar uma imagem a um comentário programaticamente. Você pode integrar facilmente o código fornecido em seus aplicativos baseados em .NET, .NET Core ou Xamarin. Além disso, você pode explorar a documentação do Aspose.Cells para .NET. Caso você tenha alguma dúvida, sinta-se à vontade para postar em nosso fórum.

Veja também