Formatar objeto de lista no Excel com Aspose.Cells

Introdução

Você já quis fazer seus dados do Excel se destacarem? Bem, se você estiver trabalhando com arquivos do Excel no .NET, Aspose.Cells é uma biblioteca fantástica que pode fazer exatamente isso. Esta ferramenta permite que você crie, formate e estilize tabelas programaticamente, entre muitas outras tarefas avançadas do Excel. Hoje, vamos mergulhar em um caso de uso específico: formatar um objeto de lista (ou tabela) no Excel. Ao final deste tutorial, você saberá como criar uma tabela de dados, adicionar estilo e até mesmo definir cálculos de resumo.

Pré-requisitos

Antes de começar o processo de codificação, certifique-se de ter algumas coisas configuradas:

  1. Visual Studio ou qualquer IDE .NET: você precisará de um ambiente de desenvolvimento para escrever e executar seu código .NET.
  2. Aspose.Cells para .NET: Certifique-se de ter a biblioteca Aspose.Cells instalada. Você pode baixá-la doPágina de download do Aspose.Cells para .NET ou instale-o via NuGet no Visual Studio.
  3. Conhecimento básico de .NET: Este guia pressupõe familiaridade com C# e .NET.
  4. Licença Aspose (opcional): para funcionalidade completa sem marcas d’água, considere obter umalicença temporária ou compre umaqui.

Pacotes de importação

Depois que você tiver tudo pronto, adicione as diretivas using necessárias ao seu código. Isso garante que todas as funcionalidades do Aspose.Cells estejam disponíveis no seu projeto.

using System.IO;
using Aspose.Cells;

Vamos dividir o processo em etapas fáceis de entender, cada uma com instruções claras.

Etapa 1: configure seu diretório de documentos

Antes de salvar qualquer arquivo, vamos especificar um diretório onde nossos arquivos de saída serão salvos. Esse caminho de diretório será usado para criar e armazenar o arquivo Excel resultante.

string dataDir = "Your Document Directory";
// Verifique se o diretório existe; caso contrário, crie-o
if (!System.IO.Directory.Exists(dataDir))
    System.IO.Directory.CreateDirectory(dataDir);

Etapa 2: Crie uma nova pasta de trabalho

Uma pasta de trabalho no Excel é como um novo arquivo ou planilha. Aqui, criamos uma nova instância doWorkbook classe para armazenar nossos dados.

Workbook workbook = new Workbook();

Etapa 3: Acesse a primeira planilha

Cada nova pasta de trabalho tem pelo menos uma planilha por padrão. Aqui, recuperaremos a primeira planilha para trabalhar.

Worksheet sheet = workbook.Worksheets[0];

Etapa 4: preencher células com dados

Agora vem a parte divertida — adicionar dados! Vamos preencher uma série de células para construir uma tabela de dados simples. Esses dados podem representar um pequeno conjunto de dados, como vendas trimestrais por funcionários e regiões.

Cells cells = sheet.Cells;
// Adicionar cabeçalhos
cells["A1"].PutValue("Employee");
cells["B1"].PutValue("Quarter");
cells["C1"].PutValue("Product");
cells["D1"].PutValue("Continent");
cells["E1"].PutValue("Country");
cells["F1"].PutValue("Sale");
// Adicionar dados de amostra
cells["A2"].PutValue("David");
cells["A3"].PutValue("David");
// Adicione mais linhas...
cells["B2"].PutValue(1);
cells["C2"].PutValue("Maxilaku");
// Continue adicionando mais dados conforme a necessidade

Esses dados são apenas um exemplo. Você pode personalizá-los de acordo com suas necessidades específicas.

Etapa 5: Adicionar um objeto de lista (tabela) à planilha

No Excel, um “List Object” se refere a uma tabela. Vamos adicionar esse objeto de lista ao intervalo que contém nossos dados. Isso facilitará a aplicação de funções de formatação e resumo.

Aspose.Cells.Tables.ListObject listObject = sheet.ListObjects[sheet.ListObjects.Add("A1", "F15", true)];

Aqui,"A1" para"F15" é o intervalo que abrange nossos dados. Otrue parâmetro significa que a primeira linha (Linha 1) deve ser tratada como cabeçalhos.

Etapa 6: estilize a tabela

Agora que nossa tabela está configurada, vamos adicionar algum estilo a ela. O Aspose.Cells fornece uma gama de estilos de tabela predefinidos, dos quais você pode escolher. Aqui, aplicaremos um estilo médio.

listObject.TableStyleType = TableStyleType.TableStyleMedium10;

Experimente estilos diferentes (comoTableStyleMedium9 ouTableStyleDark1) para encontrar um que atenda às suas necessidades.

Etapa 7: Exibir linha de totais

Vamos adicionar uma linha de totais para resumir nossos dados. OShowTotals propriedade habilitará uma nova linha na parte inferior da tabela.

listObject.ShowTotals = true;

Etapa 8: Defina o tipo de cálculo para a linha de totais

Na linha de totais, podemos especificar que tipo de cálculo queremos para cada coluna. Por exemplo, vamos contar o número de entradas na coluna “Trimestre”.

listObject.ListColumns[1].TotalsCalculation = TotalsCalculation.Count;

Esta linha de código define o cálculo dos totais para a coluna “Trimestre” comoCount . Você também pode usar opções comoSum, Average, e muito mais com base em suas necessidades.

Etapa 9: Salve a pasta de trabalho

Por fim, vamos salvar a pasta de trabalho como um arquivo Excel no diretório que configuramos anteriormente.

workbook.Save(dataDir + "output.xlsx");

Isso criará um arquivo Excel totalmente formatado e estilizado contendo sua tabela.

Conclusão

aí está — uma tabela do Excel totalmente estilizada e funcional criada programaticamente com o Aspose.Cells para .NET. Ao seguir este tutorial, você aprendeu como configurar uma tabela de dados, adicionar estilos e calcular totais, tudo com apenas algumas linhas de código. O Aspose.Cells é uma ferramenta poderosa e, com ela, você pode criar documentos do Excel dinâmicos e visualmente atraentes diretamente de seus aplicativos .NET.

Perguntas frequentes

O que é Aspose.Cells?

Aspose.Cells é uma biblioteca .NET projetada para ajudar desenvolvedores a criar, manipular e converter arquivos Excel programaticamente. Ela fornece opções poderosas para trabalhar com planilhas, gráficos, tabelas e muito mais.

Posso testar o Aspose.Cells gratuitamente?

Sim, você pode obter umteste gratuito do Aspose.Cells para explorar seus recursos. Para acesso total sem limitações, considere obter umlicença temporária.

Como adiciono mais estilos à minha tabela do Excel?

Aspose.Cells oferece uma variedade deTableStyleType opções para estilizar tabelas. Experimente valores diferentes comoTableStyleLight1 ouTableStyleDark10 para alterar a aparência da sua mesa.

Posso usar fórmulas personalizadas na linha de totais?

Absolutamente! Você pode definir fórmulas personalizadas usando oListColumn.TotalsCalculationpropriedade para aplicar cálculos específicos como soma, média ou fórmulas personalizadas.

É possível automatizar arquivos do Excel sem o Excel instalado?

Sim, o Aspose.Cells é uma API autônoma que não exige que o Microsoft Excel esteja instalado no servidor ou na máquina que executa o código.

Crie um objeto de lista no Excel usando Aspose.Cells Converter tabela em ODS usando Aspose.Cells