Usando formatos numéricos integrados no Excel programaticamente

Introdução

Neste tutorial, mostraremos como usar formatos numéricos integrados no Excel usando o Aspose.Cells para .NET. Abordaremos tudo, desde a configuração do seu ambiente até a aplicação de diferentes formatos, como datas, porcentagens e moedas. Seja você um profissional experiente ou esteja apenas dando os primeiros passos no ecossistema .NET, este guia fará com que você formate células do Excel com facilidade.

Pré-requisitos

Antes de mergulhar, certifique-se de ter o seguinte:

  • Biblioteca Aspose.Cells para .NET instalada. Você podebaixe aqui.
  • Conhecimento prático de C# e programação básica em .NET.
  • Visual Studio ou qualquer IDE .NET instalado em sua máquina.
  • Uma licença Aspose válida oulicença temporária.
  • .NET framework instalado (versão 4.0 ou superior).

Se estiver faltando alguma das opções acima, siga os links fornecidos para configurar tudo. Pronto? Vamos pular para a parte divertida!

Pacotes de importação

Antes de começarmos o tutorial, certifique-se de importar os namespaces necessários para trabalhar com o Aspose.Cells para .NET:

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

Depois de importá-los, você está pronto para manipular arquivos do Excel programaticamente. Agora, vamos mergulhar no guia passo a passo!

Etapa 1: Crie ou acesse sua pasta de trabalho do Excel

Nesta etapa, você criará uma nova pasta de trabalho. Pense nisso como abrir um novo arquivo do Excel, exceto que você está fazendo isso por meio de código!

// 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);
// Instanciando um objeto Workbook
Workbook workbook = new Workbook();

Aqui, estamos simplesmente instanciando um novoWorkbook objeto. Isso atua como seu arquivo Excel, pronto para manipulação de dados. Você também pode carregar um arquivo existente fornecendo seu caminho.

Etapa 2: Acesse a planilha

As pastas de trabalho do Excel podem conter várias planilhas. Nesta etapa, acessaremos a primeira planilha em sua pasta de trabalho:

Worksheet worksheet = workbook.Worksheets[0];

Agora estamos acessando a primeira planilha na pasta de trabalho. Se você precisar manipular planilhas adicionais, você pode referenciá-las usando seu índice ou nome.

Etapa 3: Adicionar dados às células

Vamos começar a adicionar alguns dados a células específicas. Primeiro, inseriremos a data atual do sistema na célula “A1”:

worksheet.Cells["A1"].PutValue(DateTime.Now);

Esta linha insere a data atual na célula A1. Bem legal, não é? Imagine fazer isso manualmente para centenas de células — seria um pesadelo. Agora, vamos passar para a formatação!

Etapa 4: formatar data na célula “A1”

Em seguida, vamos formatar essa data em um formato mais legível, como “15-Out-24”. É aqui que o Aspose.Cells realmente brilha:

  1. Recupere o estilo da célula:
Style style = worksheet.Cells["A1"].GetStyle();

Aqui, estamos pegando o estilo da célula A1. Pense nisso como pegar o “fashion” da célula antes de fazer qualquer ajuste. 2. Defina o formato da data:

style.Number = 15;

Definindo oNumber propriedade para 15 aplica o formato de data desejado. Este é um código de formato numérico integrado para exibir datas no formato “d-mmm-aa”. 3. Aplique o estilo à célula:

worksheet.Cells["A1"].SetStyle(style);

Esta linha aplica as alterações de estilo à célula. Agora, em vez de um formato de data padrão, você verá algo muito mais amigável ao usuário, como “15-Out-24”.

Etapa 5: Adicionar e formatar uma porcentagem na célula “A2”

Vamos prosseguir para a formatação de porcentagens. Imagine que você queira inserir um valor e exibi-lo como uma porcentagem. Nesta etapa, adicionaremos um valor numérico à célula “A2” e o formatamos como uma porcentagem:

  1. Inserir valor numérico:
worksheet.Cells["A2"].PutValue(20);

Isso insere o número 20 na célula A2. Você pode estar pensando: “Isso é apenas um número simples — como transformo isso em uma porcentagem?” Bem, estamos prestes a chegar lá. 2. Recupere o estilo e defina o formato de porcentagem:

style = worksheet.Cells["A2"].GetStyle();
style.Number = 9;  // Formato como porcentagem
worksheet.Cells["A2"].SetStyle(style);
    ```
Setting the `Number` property to 9 applies the built-in percentage format. Now the value in A2 will be displayed as "2000%." (Yes, 20 is treated as 2000% in percentage formatting).
## Step 6: Add and Format Currency in Cell "A3"
Now, let’s add a numeric value in cell A3 and format it as currency. This is a common use case for financial reports.
1. Insert Numeric Value:
```csharp
worksheet.Cells["A3"].PutValue(2546);

Aqui, estamos adicionando 2546 à célula A3. Em seguida, formataremos esse número para aparecer como moeda. 2. Recupere o estilo e defina o formato da moeda:

style = worksheet.Cells["A3"].GetStyle();
style.Number = 6;  // Formatar como moeda
worksheet.Cells["A3"].SetStyle(style);

Definindo oNumber propriedade para 6 aplica o formato de moeda. Agora o valor na célula A3 será exibido como “2.546,00”, completo com vírgulas e duas casas decimais.

Etapa 7: Salve o arquivo Excel

Agora que aplicamos toda a mágica da formatação, é hora de salvar o arquivo:

// Salvando o arquivo Excel
workbook.Save(dataDir + "book1.out.xls", SaveFormat.Excel97To2003);

Esta linha salva o arquivo Excel no formato Excel 97-2003. Você pode alterar oSaveFormatpara atender às suas necessidades. E assim, você criou e formatou um arquivo Excel programaticamente!

Conclusão

Parabéns! Você aprendeu com sucesso como usar o Aspose.Cells for .NET para aplicar formatos numéricos integrados a células em um arquivo do Excel. De datas a porcentagens e moedas, cobrimos algumas das necessidades de formatação mais comuns para processamento de dados do Excel. Agora, em vez de formatar células manualmente, você pode automatizar todo o processo, economizando tempo e reduzindo erros.

Perguntas frequentes

Posso aplicar formatos numéricos personalizados usando o Aspose.Cells para .NET?

Sim! Além dos formatos integrados, o Aspose.Cells também suporta formatos numéricos personalizados. Você pode criar formatos altamente específicos usando oCustom propriedade noStyle aula.

Como posso formatar uma célula como uma moeda com um símbolo específico?

Para aplicar um símbolo de moeda específico, você pode usar a formatação personalizada definindo oStyle.Custom propriedade.

Posso formatar linhas ou colunas inteiras?

Absolutamente! Você pode aplicar estilos a linhas ou colunas inteiras usando oRows ouColumnscoleções noWorksheet objeto.

Como posso formatar várias células de uma só vez?

Você pode usar oRange objeto para selecionar várias células e aplicar estilos a todas elas de uma só vez.

Preciso ter o Microsoft Excel instalado para usar o Aspose.Cells?

Não, o Aspose.Cells funciona independentemente do Microsoft Excel, então você não precisa do Excel instalado na sua máquina.

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