Comentários encadeados no Excel são um recurso essencial para o trabalho colaborativo. Ele permite que vários usuários adicionem, editem e revisem tópicos de conversa em um documento compartilhado. Em certos casos, poderemos precisar gerenciar esses comentários encadeados de forma programática. Nesta postagem do blog, aprenderemos como ler, adicionar e editar comentários encadeados no Excel usando C#.
Este artigo cobre os seguintes tópicos:
- API C# Excel para gerenciamento de comentários encadeados
- Adicionar comentários encadeados no Excel usando C#
- Leia comentários encadeados para uma célula específica no Excel
- Leia todos os comentários encadeados no Excel usando C#
- Editar um comentário encadeado no Excel usando C#
- Excluir comentários encadeados no Excel usando C#
- Recursos Gratuitos
API C# Excel para gerenciamento de comentários encadeados
Para trabalhar com comentários encadeados em planilhas do Excel, usaremos a API Aspose.Cells for .NET. É uma poderosa API de programação de planilhas que permite aos desenvolvedores criar, manipular e converter arquivos Excel em aplicativos .NET. Ao aproveitar o Aspose.Cells for .NET, podemos facilmente adicionar, ler, editar ou excluir comentários encadeados em planilhas do Excel.
Para utilizar a API, baixe a DLL ou instale-a do NuGet com o seguinte comando:
PM> Install-Package Aspose.Cells
Adicione um comentário encadeado no Excel usando C#
Podemos adicionar facilmente comentários encadeados a uma planilha do Excel seguindo as etapas abaixo:
- Crie uma instância da classe Workbook.
- Acesse a planilha específica pelo seu índice.
- Adicione um autor à coleção ThreadedCommentAuthors usando o método Add().
- Obtenha o objeto da classe ThreadedCommentAuthor para o autor recém-criado por seu índice.
- Adicione o comentário encadeado usando o método AddThreadedComment().Ele usa o nome da célula, o texto do comentário e o objeto ThreadedCommentAuthor como argumentos.
- Salve o arquivo Excel usando o método Workbook.Save(string).
O exemplo de código a seguir mostra como adicionar um comentário encadeado a uma planilha do Excel usando C#.
// Este exemplo de código demonstra como adicionar comentários encadeados em uma planilha do Excel
// Crie uma instância da classe Workbook
Workbook workbook = new Workbook();
// Acesse a primeira planilha
Worksheet worksheet = workbook.Worksheets[0];
// Adicionar um autor
var authorIndex = workbook.Worksheets.ThreadedCommentAuthors.Add("Aspose Test", "", "");
var author = workbook.Worksheets.ThreadedCommentAuthors[authorIndex];
// Adicionar comentário encadeado
worksheet.Comments.AddThreadedComment("A1", "Test Threaded Comment", author);
// Salve o arquivo de saída
workbook.Save("AddThreadedComments_out.xlsx");
Leia comentários encadeados para uma célula específica no Excel
Para ler comentários encadeados de uma célula especificada em uma planilha do Excel, siga estas etapas:
- Carregue um arquivo Excel existente usando a classe Workbook.
- Acesse a planilha pelo seu índice.
- Obtenha comentários encadeados para uma célula específica usando o método GetThreadedComments().Leva o nome da célula como argumento.
- Percorra todos os comentários encadeados e leia os detalhes.
O exemplo de código a seguir mostra como ler comentários encadeados para a coluna especificada de uma planilha do Excel usando C#.
// Este exemplo de código demonstra como ler comentários encadeados para uma célula especificada em uma planilha do Excel
// Carregar um arquivo Excel existente
Workbook workbook = new Workbook("AddThreadedComments_out.xlsx");
// Acesse a primeira planilha
Worksheet worksheet = workbook.Worksheets[0];
// Obtenha comentários encadeados para uma célula específica
var threadedComments = worksheet.Comments.GetThreadedComments("A1");
// Leia os comentários encadeados
foreach (var comment in threadedComments)
{
Console.WriteLine("Author Name: " + comment.Author.Name);
Console.WriteLine("Threaded comment Notes:" + comment.Notes);
}
Author Name: author@domain.com
Threaded comment Notes:Test Threaded Comment
Leia todos os comentários encadeados no Excel usando C#
Da mesma forma, podemos ler todos os comentários encadeados disponíveis em uma planilha do Excel seguindo as etapas abaixo:
- Carregue um arquivo Excel existente usando a classe Workbook.
- Percorra todos os comentários e leia os comentários encadeados um por um.
O exemplo de código a seguir mostra como ler todos os comentários encadeados de uma planilha do Excel usando C#.
// Este exemplo de código demonstra como ler comentários encadeados para uma célula especificada em uma planilha do Excel
// Carregar um arquivo Excel existente
Workbook workbook = new Workbook("AddThreadedComments_out.xlsx");
// Acesse a primeira planilha
Worksheet worksheet = workbook.Worksheets[0];
// Receba todos os comentários
var comments = worksheet.Comments;
// Leia todos os comentários encadeados
foreach (var comment in comments)
{
// Processar comentários encadeados
foreach (var threadedComment in comment.ThreadedComments)
{
Console.WriteLine("Author Name: " + threadedComment.Author.Name);
Console.WriteLine("Threaded comment author User Id: " + threadedComment.Author.UserId);
Console.WriteLine("Threaded comment author ProviderId:" + threadedComment.Author.ProviderId);
Console.WriteLine("Threaded comment Notes:" + threadedComment.Notes);
}
}
Edite um comentário encadeado no Excel usando C#
Siga as etapas abaixo para atualizar qualquer um dos comentários encadeados no Excel:
- Carregue um arquivo Excel existente usando a classe Workbook.
- Acesse a planilha pelo seu índice.
- Obtenha comentários encadeados para uma célula específica usando o método GetThreadedComments().Leva o nome da célula como argumento.
- Atualize a propriedade de notas do comentário.
- Salve o arquivo Excel usando o método Workbook.Save(string).
O exemplo de código a seguir mostra como editar comentários encadeados em uma planilha do Excel usando C#.
// Este exemplo de código demonstra como editar comentários encadeados em uma planilha do Excel
// Carregar um arquivo Excel existente
Workbook workbook = new Workbook("AddThreadedComments_out.xlsx");
// Acesse a primeira planilha
Worksheet worksheet = workbook.Worksheets[0];
// Obtenha comentários encadeados para uma célula específica
var threadedComments = worksheet.Comments.GetThreadedComments("A1");
var comment = threadedComments[0];
// Atualizar a nota de comentário
comment.Notes = "Updated Comment";
// Salve o arquivo de saída
workbook.Save("EditThreadedComments.xlsx");
Excluir comentários encadeados no Excel usando C#
Também podemos excluir os comentários encadeados de uma célula específica em uma planilha do Excel seguindo as etapas abaixo:
- Carregue um arquivo Excel existente usando a classe Workbook.
- Acesse a planilha pelo seu índice.
- Remova um comentário da coleção de comentários usando o método RemoveAt().Leva o nome da célula como argumento.
- Salve o arquivo Excel usando o método Save(string).
O exemplo de código a seguir mostra como excluir comentários encadeados em uma planilha do Excel usando C#.
// Este exemplo de código demonstra como excluir comentários encadeados em uma planilha do Excel
// Carregar um arquivo Excel existente
Workbook workbook = new Workbook("AddThreadedComments_out.xlsx");
// Receba todos os comentários
var comments = workbook.Worksheets[0].Comments;
// Remover comentários
comments.RemoveAt("A1");
// Salve o arquivo de saída
workbook.Save("DeleteThreadedComments.xlsx");
Obtenha uma licença gratuita
Por favor, obtenha uma licença temporária gratuita para ler, adicionar e editar comentários encadeados no Excel sem restrições de teste. Visite nossa página ‘Licença temporária’ para obter instruções fáceis de seguir sobre como reivindicar sua licença gratuita rapidamente.
Comentários encadeados no Excel – Recursos gratuitos
Além de trabalhar com comentários encadeados em planilhas do Excel, você pode aprender mais sobre como criar, manipular e converter arquivos do Excel. Explore vários outros recursos do Aspose.Cells for .NET usando os recursos abaixo:
Conclusão
Neste artigo, aprendemos como ler, adicionar, editar e excluir comentários encadeados de planilhas do Excel usando C#. Ao aproveitar o Aspose.Cell for .NET, você pode manipular facilmente planilhas do Excel em seus aplicativos C#. Em caso de qualquer ambigüidade, entre em contato conosco em nosso fórum de suporte gratuito.