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
- Adicionar comentários em uma planilha do Excel
- Adicionar imagem a um comentário no Excel
- Aplicar formatação a comentários no Excel
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#.
- Carregue o arquivo Excel usando a classe Workbook.
- Obtenha a referência da Worksheet desejada da coleção Workbook.Worksheets.
- Adicione um comentário à planilha usando o método Worksheet.Comments.Add(string) e obtenha a referência do comentário em um objeto Comment.
- Defina a nota do comentário usando a propriedade Comment.Note.
- Salve o arquivo Excel atualizado usando o método Workbook.Save(string).
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.
- Carregue o arquivo Excel usando a classe Workbook.
- Obtenha a referência do CommentCollection na planilha desejada usando a propriedade Workbook.Worksheets[index].Comments.
- Adicione um novo comentário à coleção e obtenha sua referência no objeto Comment.
- Defina a nota do comentário usando a propriedade Comment.Note.
- Carregue a imagem do arquivo em um objeto Bitmap.
- Salve o Bitmap em um objeto MemoryStream.
- Adicione imagem ao comentário usando a propriedade Comment.CommentShape.Fill.ImageData.
- Salve o arquivo Excel atualizado usando o método Workbook.Save(string).
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#.
- Carregue o arquivo Excel usando a classe Workbook.
- Obtenha a referência da Worksheet desejada da coleção Workbook.Worksheets.
- Adicione um comentário à planilha usando o método Worksheet.Comments.Add(string) e obtenha a referência do comentário em um objeto Comment.
- Defina a nota do comentário usando a propriedade Comment.Note.
- Defina as opções de formatação desejadas do comentário.
- Salve o arquivo Excel atualizado usando o método Workbook.Save(string).
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.