Personalizando formatos de exibição com números definidos pelo usuário

Introdução

Trabalhar com arquivos do Excel geralmente requer formatação personalizada de células para apresentar dados de uma forma mais significativa e amigável. Imagine que você está criando um arquivo do Excel para um relatório. Você não quer apenas números brutos. Você quer que datas, porcentagens e moedas pareçam elegantes e profissionais, certo? É aí que os formatos de exibição personalizados entram em cena. Neste tutorial, estamos nos aprofundando no Aspose.Cells para .NET para mostrar como personalizar o formato de exibição de números usando configurações definidas pelo usuário.

Pré-requisitos

Antes de começar, certifique-se de que você tem tudo pronto para seguir este tutorial. Aqui está o que você vai precisar:

  • Aspose.Cells para .NET instalado.Baixe aqui.
  • Conhecimento básico de C# e .NET framework.
  • Uma licença válida para Aspose.Cells. Se você não tiver uma, pegue umateste gratuito ou solicite umlicença temporária.
  • Um IDE como o Visual Studio.
  • .NET Framework 4.0 ou superior. Se estiver faltando alguma coisa, não se preocupe. Você sempre pode revisitar esses links para baixar os arquivos necessários ou buscar ajuda doFórum de suporte Aspose.

Importar namespaces

Antes de começar a usar o código, você precisa importar os namespaces necessários para acessar todas as funcionalidades necessárias do Aspose.Cells.

using System.IO;
using Aspose.Cells;
using System;

Esses dois namespaces serão suas principais ferramentas neste tutorial. Agora, vamos para a parte divertida:

Etapa 1: Configurando o diretório do projeto

Primeiro, você precisa de um lugar para armazenar seus arquivos, certo? Vamos criar um diretório para salvar o arquivo Excel de saída. Nesta etapa, também garantiremos que o diretório exista antes de salvar qualquer coisa.

// O caminho para o diretório de documentos.
string dataDir = "Your Document Directory";
// Crie um diretório se ele ainda não estiver presente.
bool IsExists = System.IO.Directory.Exists(dataDir);
if (!IsExists)
    System.IO.Directory.CreateDirectory(dataDir);
  • Estamos definindo umdataDir variável para armazenar o caminho onde o arquivo de saída do Excel irá.
  • Em seguida, verificamos se o diretório existe usandoSystem.IO.Directory.Exists().
  • Se o diretório não existir, ele será criado usandoSystem.IO.Directory.CreateDirectory().

Etapa 2: Crie uma nova pasta de trabalho e adicione uma planilha

Agora que temos nosso diretório, vamos criar uma nova pasta de trabalho do Excel e adicionar uma planilha a ela.

// Instanciando um objeto Workbook
Workbook workbook = new Workbook();
// Adicionar uma nova planilha ao objeto Excel
int i = workbook.Worksheets.Add();
// Obtendo a referência da planilha recém-adicionada passando seu índice de planilha
Worksheet worksheet = workbook.Worksheets[i];
  • Primeiro, criamos um novoWorkbook objeto. Pense nisso como seu arquivo Excel.
  • Adicionamos uma nova planilha a esta pasta de trabalho usando oAdd()método e armazenar o índice na variáveli.
  • Referenciamos esta planilha usando oworkbook.Worksheets[i].

Etapa 3: Adicionar data a uma célula e personalizar seu formato

Agora, vamos inserir a data atual em uma célula e formatá-la para exibir de forma personalizada. Em vez do formato de data padrão, definiremos um formato personalizado comod-mmm-yy.

// Adicionando a data atual do sistema à célula "A1"
worksheet.Cells["A1"].PutValue(DateTime.Now);
// Obtendo o estilo da célula A1
Style style = worksheet.Cells["A1"].GetStyle();
// Definir o formato de exibição personalizado para mostrar a data como "d-mmm-aa"
style.Custom = "d-mmm-yy";
// Aplicando o estilo à célula A1
worksheet.Cells["A1"].SetStyle(style);
  • Adicionamos a data atual do sistema à célulaA1 usandoPutValue(DateTime.Now).
  • Recuperamos o estilo atual da célulaA1 usandoGetStyle().
  • Modificamos o estilo da célula definindostyle.Custom = "d-mmm-yy", que formata a data para mostrar o dia, o mês abreviado e o ano.
  • Por fim, aplicamos o novo estilo à célula comSetStyle().

Etapa 4: Formatando uma célula como uma porcentagem

A seguir, vamos trabalhar com números. Adicionaremos um valor numérico a outra célula, digamosA2e formate-o como uma porcentagem.

//Adicionar um valor numérico à célula "A2"
worksheet.Cells["A2"].PutValue(20);
// Obtendo o estilo da célula A2
style = worksheet.Cells["A2"].GetStyle();
// Definir o formato de exibição personalizado para mostrar o valor como porcentagem
style.Custom = "0.0%";
// Aplicando o estilo à célula A2
worksheet.Cells["A2"].SetStyle(style);
  • Nós adicionamos o valor20 para a célulaA2.
  • Recuperamos o estilo da célulaA2 e defina o formato personalizado para0.0% para exibir o valor como uma porcentagem (ou seja, 20%).
  • Por fim, aplicamos o estilo à célula usandoSetStyle().

Etapa 5: Formatando uma célula como moeda

Vamos adicionar outro valor, digamos, à célulaA3, e formatá-lo para exibir como moeda. Para tornar as coisas mais interessantes, usaremos um formato que exibe valores positivos como moeda em libras e valores negativos em dólares.

// Adicionar um valor numérico à célula "A3"
worksheet.Cells["A3"].PutValue(2546);
// Obtendo o estilo da célula A3
style = worksheet.Cells["A3"].GetStyle();
// Definir o formato de exibição personalizado para mostrar o valor como moeda
style.Custom = "£#,##0;[Red]$-#,##0";
// Aplicando o estilo à célula A3
worksheet.Cells["A3"].SetStyle(style);
  • Nós adicionamos o valor2546 para a célulaA3.
  • Definimos um formato personalizado£#,##0;[Red]$-#,##0, que exibe valores positivos com um símbolo de libra e valores negativos em vermelho com um símbolo de dólar.
  • Aplicamos o estilo à célula usandoSetStyle().

Etapa 6: Salvando a pasta de trabalho

O passo final é salvar a pasta de trabalho como um arquivo Excel. Usaremos o formato Excel 97-2003 para este tutorial.

// Salvando o arquivo Excel
workbook.Save(dataDir + "book1.out.xls", SaveFormat.Excel97To2003);
  • OSave() O método salva a pasta de trabalho no diretório especificado.
  • Nós escolhemosSaveFormat.Excel97To2003 para garantir compatibilidade com versões mais antigas do Excel.

Conclusão

Pronto! Acabamos de criar um arquivo Excel, adicionamos formatos personalizados de data, porcentagem e moeda a células específicas usando o Aspose.Cells para .NET e salvamos o arquivo. A formatação personalizada torna seus arquivos Excel muito mais legíveis e profissionais. Não se esqueça de explorar outras opções de formatação no Aspose.Cells, como formatação condicional, para ter ainda mais controle sobre a aparência dos seus dados.

Perguntas frequentes

Como posso aplicar opções de formatação mais complexas no Aspose.Cells?

Você pode combinar diferentes estilos de formatação, como cor da fonte, bordas e cores de fundo, com formatos numéricos personalizados.

Posso aplicar um formato numérico personalizado a um intervalo de células?

Sim, o Aspose.Cells permite que você aplique um estilo a um intervalo de células usando oRange.SetStyle() método.

Em quais outros formatos de arquivo posso salvar a pasta de trabalho?

Aspose.Cells suporta muitos formatos, incluindo XLSX, CSV e PDF. Basta alterar oSaveFormat noSave() método.

Posso formatar números negativos de forma diferente?

Absolutamente! Você pode usar formatos de números personalizados para exibir números negativos com cores ou símbolos diferentes.

O Aspose.Cells para .NET é gratuito?

O Aspose.Cells oferece um teste gratuito, mas para funcionalidade completa, você precisará de uma licença válida. Você pode obter umalicença temporária aqui.

Usando formatos numéricos integrados no Excel programaticamente