Como definir formatos de dados de células em C# com IronXL
O IronXL permite formatar células de Excel com formatos de dados integrados, como moeda, percentuais, datas e formatos numéricos personalizados, definindo a propriedade FormatString em células ou intervalos sem dependências de Interop.
Este exemplo mostra como criar uma nova planilha do Excel e aplicar uma formatação integrada a uma célula específica usando a API do IronXL. Nenhuma dependência de Interop necessária — basta definir FormatString e salvar.
-
1Install IronXL with NuGet Package Manager
-
2Copie e execute este trecho de código.
IronXL.WorkBook book = IronXL.WorkBook.Create(); book.DefaultWorkSheet["B2"].FormatString = IronXL.Formatting.BuiltinFormats.Currency2;C# -
3Implante para testar em seu ambiente de produção.
Comece a usar IronXL em seu projeto hoje com uma avaliação gratuita
Fluxo de trabalho mínimo (5 etapas)
- Baixe a biblioteca C# para definir o formato dos dados.
- Abra uma planilha do Excel existente ou crie uma nova.
- Defina a propriedade FormatString da célula, coluna, linha ou intervalo para o formato de dados desejado.
- Use o formato de dados integrado com a classe BuiltinFormats
- Exporte a planilha editada em vários tipos de arquivo.
Como faço para definir formatos de dados de células no Excel?
A propriedade FormatString pode ser acessada através de células e intervalos. Portanto, é possível definir formatos de dados para células, colunas, linhas individuais e qualquer intervalo selecionado. Essa flexibilidade torna o IronXL particularmente poderoso quando você precisa trabalhar com arquivos do Excel em C# sem interoperabilidade .
A formatação de dados é essencial para apresentar informações de forma clara em planilhas. Seja na criação de relatórios financeiros com valores monetários, dados científicos com casas decimais precisas ou análises baseadas em datas, a formatação adequada garante que seus dados sejam legíveis e profissionais. O IronXL simplifica esse processo, fornecendo acesso direto ao mecanismo de formatação do Excel por meio de uma API simples.
using IronXL;
using IronXL.Formatting;
using System;
using System.Linq;
// Create a new workbook
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;
// Set the data format to 12300.00%
workSheet["A1"].Value = 123;
workSheet["A1"].FormatString = BuiltinFormats.Percent2;
// Set the data format to 123.0000
workSheet["A2"].Value = 123;
workSheet["A2"].FormatString = "0.0000";
// Set data display format to range
DateTime dateValue = new DateTime(2020, 1, 1, 12, 12, 12);
workSheet["A3"].Value = dateValue;
workSheet["A4"].Value = new DateTime(2022, 3, 3, 10, 10, 10);
workSheet["A5"].Value = new DateTime(2021, 2, 2, 11, 11, 11);
IronXL.Range range = workSheet["A3:A5"];
// Set the data format to 1/1/2020 12:12:12
range.FormatString = "MM/dd/yy h:mm:ss";
workBook.SaveAs("dataFormats.xlsx");Imports IronXL
Imports IronXL.Formatting
Imports System
Imports System.Linq
' Create a new workbook
Private workBook As WorkBook = WorkBook.Create()
Private workSheet As WorkSheet = workBook.DefaultWorkSheet
' Set the data format to 12300.00%
Private workSheet("A1").Value = 123
Private workSheet("A1").FormatString = BuiltinFormats.Percent2
' Set the data format to 123.0000
Private workSheet("A2").Value = 123
Private workSheet("A2").FormatString = "0.0000"
' Set data display format to range
Private dateValue As New DateTime(2020, 1, 1, 12, 12, 12)
Private workSheet("A3").Value = dateValue
Private workSheet("A4").Value = New DateTime(2022, 3, 3, 10, 10, 10)
Private workSheet("A5").Value = New DateTime(2021, 2, 2, 11, 11, 11)
Private range As IronXL.Range = workSheet("A3:A5")
' Set the data format to 1/1/2020 12:12:12
range.FormatString = "MM/dd/yy h:mm:ss"
workBook.SaveAs("dataFormats.xlsx")
Como posso definir os valores das células como strings sem conversão?
Ao definir o valor no IronXL, use StringValue em vez de Value para atribuir diretamente o valor exato à célula sem conversão automática. Isso funciona como colocar um apóstrofo antes do valor da célula no Excel. Essa técnica é particularmente útil ao trabalhar com códigos de produtos, números de telefone ou outros dados que devem permanecer como texto. Para manipulação de strings mais avançada, veja como escrever valores do Excel em .NET .
// Assign value as string
workSheet["A1"].StringValue = "4402-12";' Assign value as string
workSheet("A1").StringValue = "4402-12"Como faço para usar os formatos integrados no IronXL?
A biblioteca IronXL oferece uma variedade de strings de formato predefinidas que podem ser acessadas através da classe IronXL.Formatting.BuiltinFormats para formatar células do Excel. Isso permite personalizar a forma como os dados são exibidos em suas planilhas do Excel. Esses formatos integrados abrangem os cenários de negócios mais comuns e são compatíveis com todas as versões do Excel.
Ao criar planilhas programaticamente, aplicar uma formatação consistente é crucial para manter padrões profissionais em todos os seus documentos. A classe BuiltinFormats fornece mais de 30 padrões de formato pré-configurados que correspondem às opções de formatação padrão do Excel.
using IronXL;
using IronXL.Formatting;
// Create a new workbook
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;
// Use builtin formats
workSheet["A1"].Value = 123;
workSheet["A1"].FormatString = BuiltinFormats.Accounting0;
workBook.SaveAs("builtinDataFormats.xlsx");Imports IronXL
Imports IronXL.Formatting
' Create a new workbook
Private workBook As WorkBook = WorkBook.Create()
Private workSheet As WorkSheet = workBook.DefaultWorkSheet
' Use builtin formats
Private workSheet("A1").Value = 123
Private workSheet("A1").FormatString = BuiltinFormats.Accounting0
workBook.SaveAs("builtinDataFormats.xlsx")Quais formatos de dados integrados estão disponíveis?
Para o tipo Duration, os valores de entrada são representados em dias. Por exemplo, 1 dia equivale a 24 horas, e 1,05 dias equivalem a 25 horas e 12 minutos. Isso é particularmente útil ao trabalhar com dados do Excel que envolvem controle de tempo ou gerenciamento de projetos. Aqui estão os tipos de formato disponíveis:
Qual a função de cada tipo de formato?
General: Formato padrão exibindo números sem formatação específica.Duration1: Mostra duração em minutos e segundos como "mm:ss."Duration2: Mostra duração em horas, minutos e segundos como "[h]:mm:ss."Duration3: Mostra duração em minutos, segundos e milissegundos como "mm:ss.0."Accounting0: Formato contábil sem decimais, parênteses para negativos como "#,##0_);(#,##0)."Accounting0Red: Formato contábil sem decimais, vermelho para negativos como "#,##0_);Red."Accounting2: Formato contábil com dois decimais, parênteses para negativos como "#,##0.00;(#,##0.00)."Accounting2Red: Formato contábil com dois decimais, vermelho para negativos como "#,##0.00_);Red."Time1: Formato de 12 horas com AM/PM como "h:mm AM/PM."Time2: Formato de 12 horas com segundos e AM/PM como "h:mm:ss AM/PM."Time3: Formato de 24 horas sem segundos como "h:mm."Time4: Formato de 24 horas com segundos como "h:mm:ss."ShortDate: Formato de data curta como "m/d/yy."ShortDateAndTime: Formato de data e hora curta como "m/d/yy h:mm."LongDate1: Data longa com mês, dia, ano como "d-mmm-yy."LongDate2: Data longa com dia e mês abreviado como "d-mmm."LongDate3: Data longa com mês abreviado e ano como "mmm-yy."Fraction1: Valores fracionários com um dígito como "# ?/?."Fraction2: Valores fracionários com dois dígitos como "# ??/??."Scientific1: Notação científica com um decimal como "##0.0E+0."Scientific2: Notação científica com dois decimais como "0.00E+00."Percent: Percentual sem decimais como "0%."Percent2: Percentual com dois decimais como "0.00%."Currency0: Moeda sem decimais, parênteses para negativos como "$#,##0_);($#,##0)."Currency0Red: Moeda sem decimais, vermelho para negativos como "$#,##0_);Red."Currency2: Moeda com dois decimais, parênteses para negativos como "$#,##0.00;($#,##0.00)."Currency2Red: Moeda com dois decimais, vermelho para negativos como "$#,##0.00_);Red."Thousands0: Números com separador de milhares, sem decimais como "#,##0."Thousands2: Números com separador de milhares, dois decimais como "#,##0.00."Number0: Números sem decimais como "0."Number2: Números com dois decimais como "0.00."Text: Formato de texto simples como "@."
A formatação de dados e a formatação de números no Excel controlam como números, datas, horas e outros dados são exibidos nas células, melhorando a legibilidade e garantindo a precisão dos dados. Com os formatos de dados, você pode apresentar informações em formatos específicos, como porcentagens ou moedas. Da mesma forma, os formatos de número permitem personalizar as casas decimais e as opções de exibição.
Como aplicar vários formatos a diferentes intervalos?
Em aplicações do mundo real, muitas vezes é necessário aplicar formatos diferentes a várias partes da planilha. Este exemplo demonstra a formatação de um relatório financeiro com múltiplos tipos de dados. Essa abordagem é particularmente útil ao exportar para o Excel em C# a partir de bancos de dados ou outras fontes de dados.
using IronXL;
using IronXL.Formatting;
using System;
// Create a financial report with multiple formats
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;
// Headers
workSheet["A1"].Value = "Financial Report Q4 2023";
workSheet["A1"].Style.Font.Bold = true;
// Revenue section with currency formatting
workSheet["A3"].Value = "Revenue";
workSheet["B3"].Value = 2500000;
workSheet["B3"].FormatString = BuiltinFormats.Currency0;
// Growth percentage
workSheet["A4"].Value = "YoY Growth";
workSheet["B4"].Value = 0.157;
workSheet["B4"].FormatString = BuiltinFormats.Percent2;
// Date formatting
workSheet["A6"].Value = "Report Date";
workSheet["B6"].Value = DateTime.Now;
workSheet["B6"].FormatString = BuiltinFormats.LongDate1;
// Apply accounting format to expense columns
IronXL.Range expenseRange = workSheet["B8:B12"];
expenseRange.FormatString = BuiltinFormats.Accounting2Red;
// Save the formatted report
workBook.SaveAs("FinancialReport_Q4_2023.xlsx");Imports IronXL
Imports IronXL.Formatting
Imports System
' Create a financial report with multiple formats
Dim workBook As WorkBook = WorkBook.Create()
Dim workSheet As WorkSheet = workBook.DefaultWorkSheet
' Headers
workSheet("A1").Value = "Financial Report Q4 2023"
workSheet("A1").Style.Font.Bold = True
' Revenue section with currency formatting
workSheet("A3").Value = "Revenue"
workSheet("B3").Value = 2500000
workSheet("B3").FormatString = BuiltinFormats.Currency0
' Growth percentage
workSheet("A4").Value = "YoY Growth"
workSheet("B4").Value = 0.157
workSheet("B4").FormatString = BuiltinFormats.Percent2
' Date formatting
workSheet("A6").Value = "Report Date"
workSheet("B6").Value = DateTime.Now
workSheet("B6").FormatString = BuiltinFormats.LongDate1
' Apply accounting format to expense columns
Dim expenseRange As IronXL.Range = workSheet("B8:B12")
expenseRange.FormatString = BuiltinFormats.Accounting2Red
' Save the formatted report
workBook.SaveAs("FinancialReport_Q4_2023.xlsx")Este exemplo mostra como diferentes tipos de formato se combinam para criar documentos financeiros profissionais. Para opções de formatação mais avançadas, incluindo formatação condicional , você pode expandir ainda mais esses conceitos.
Ao trabalhar com grandes conjuntos de dados ou criar relatórios programaticamente, a formatação consistente torna-se fundamental. O sistema de formatação do IronXL integra-se perfeitamente com outros recursos, como funções matemáticas e edição de fórmulas , permitindo que você crie soluções de relatórios totalmente automatizadas.
Para desenvolvedores que estão migrando do Office Interop ou buscando melhor desempenho, o sistema de formatação do IronXL oferece uma vantagem significativa. Ao contrário das abordagens tradicionais, você pode formatar milhares de células de forma eficiente, sem a sobrecarga de interoperabilidade COM. Para saber mais sobre as melhores práticas de automação do Excel, explore nossa documentação completa do Excel .
Perguntas frequentes
Como formatar células do Excel em C# sem usar Interop?
O IronXL oferece uma maneira simples de formatar células do Excel sem dependências de interoperabilidade. Você pode usar a propriedade FormatString em células ou intervalos para aplicar formatos predefinidos, como moeda, porcentagens, datas e formatos de número personalizados. Basta criar ou abrir uma pasta de trabalho com o IronXL e definir a propriedade FormatString para o formato desejado.
Qual a maneira mais rápida de aplicar a formatação de moeda a uma célula?
Com o IronXL, você pode aplicar a formatação de moeda com apenas uma linha de código. Depois de criar uma planilha, basta usar: `book.DefaultWorkSheet["B2"].FormatString = IronXL.Formatting.BuiltinFormats.Currency2;` Isso aplica o formato de moeda integrado com 2 casas decimais à célula B2.
Posso formatar várias células ao mesmo tempo?
Sim, o IronXL permite formatar células individuais, colunas inteiras, linhas ou qualquer intervalo selecionado por meio da propriedade FormatString. Essa flexibilidade facilita a aplicação de formatação consistente em várias células da sua planilha do Excel sem precisar iterar por cada célula individualmente.
Como faço para impedir a conversão automática de dados ao definir os valores das células?
O IronXL oferece a propriedade StringValue para definir valores de células como strings sem conversão automática. Em vez de usar a propriedade Value, use StringValue para atribuir o valor exato à célula. Isso funciona de forma semelhante a colocar um apóstrofo antes do valor da célula no Excel e é particularmente útil para códigos de produtos, números de telefone ou outros dados que devem permanecer como texto.
Quais opções de formato integradas estão disponíveis?
O IronXL oferece uma coleção abrangente de strings de formatação predefinidas por meio da classe IronXL.Formatting.BuiltinFormats. Isso inclui vários formatos de moeda, formatos de data e hora, exibição de porcentagem, notação científica e formatos de número personalizados, permitindo que você personalize a forma como os dados são exibidos em suas planilhas do Excel.
Preciso instalar o Microsoft Excel para usar os recursos de formatação de células?
Não, o IronXL opera de forma independente, sem exigir dependências do Microsoft Excel ou de interoperabilidade. A biblioteca inclui seu próprio mecanismo de formatação que manipula diretamente arquivos do Excel, tornando-a ideal para ambientes de servidor ou sistemas onde o Excel não está instalado.
Does IronXL offer any performance benefits over Interop for Excel formatting?
IronXL provides significant performance improvements over traditional Interop by eliminating COM interop overhead, allowing efficient formatting of thousands of cells without relying on Office components.
How does IronXL's formatting enhance Excel reporting in C#?
IronXL’s formatting system integrates seamlessly with math functions and formula edits, making it invaluable for creating fully automated Excel reports programmatically.
What is a quick way to start using IronXL for formatting Excel cells?
To get started with IronXL, download the C# library, create a new or open an existing Excel worksheet, set the `FormatString` property to the desired format, and export your edited spreadsheet.
How does IronXL support data format customization?
Besides built-in formats, IronXL allows you to define custom formats using the `FormatString` property, providing flexibility when presenting specific types of data in Excel cells.
Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.
