C# CSV para XLSX: Converter arquivos CSV para o formato Excel

Como Você Converte Arquivos CSV para o Formato XLSX em C#?

A conversão principal requer o carregamento do arquivo CSV e salvá-lo no formato Excel. IronXL fornece WorkBook.LoadCSV, que analisa a fonte delimitada e cria um workbook pronto para exportação. O método aceita o caminho do arquivo, o formato Excel de destino e o caractere delimitador.

using IronXL;

// Load CSV file and convert to XLSX format
WorkBook workbook = WorkBook.LoadCSV("data.csv", fileFormat: ExcelFileFormat.XLSX, ListDelimiter: ",");

// Access the default worksheet containing CSV data
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Save as Excel XLSX file
workbook.SaveAs("output.xlsx");

using IronXL;

// Load CSV file and convert to XLSX format
WorkBook workbook = WorkBook.LoadCSV("data.csv", fileFormat: ExcelFileFormat.XLSX, ListDelimiter: ",");

// Access the default worksheet containing CSV data
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Save as Excel XLSX file
workbook.SaveAs("output.xlsx");

Quais são os Benefícios de Converter CSV para o Formato Excel?

O formato XLSX oferece vantagens mensuráveis sobre o CSV simples para a maioria dos cenários de gerenciamento de dados:

• Múltiplas Planilhas: arquivos Excel suportam várias planilhas dentro de um único livro, permitindo armazenamento de dados organizado que arquivos CSV não podem igualar. Um único arquivo XLSX pode conter dezenas de planilhas cobrindo diferentes períodos de tempo, regiões ou categorias.
• Suporte a Fórmulas: Escreva cálculos complexos, agregações e lógica condicional diretamente nas células. As fórmulas do Excel são recalculadas automaticamente quando os dados de origem mudam, eliminando a necessidade de reprocessar arquivos CSV manualmente.
• Gráficos Visuais: Crie gráficos de barras, gráficos de linhas, gráficos de pizza e outras visualizações a partir de dados da planilha. O IronXL suporta a criação de gráficos diretamente através da API, para que os gráficos sejam incorporados no arquivo XLSX.
• Formatação de Células: Controle fontes, cores, bordas e formatos de números para documentos profissionais. Os arquivos CSV armazenam apenas valores brutos; XLSX preserva a camada de exibição juntamente com os dados.
• Validação de Dados: Restrinja a entrada de célula a valores ou intervalos específicos, prevenindo erros de entrada de dados em arquivos compartilhados com usuários finais.
• Proteção por Senha: Proteja planilhas e pastas de trabalho com senhas para controlar o acesso de leitura e escrita, um recurso totalmente ausente no CSV.

Essas capacidades fazem do formato XLSX a escolha padrão para relatórios, painéis, modelos financeiros e qualquer aplicação que exija mais do que armazenamento de dados brutos.

Como instalar o IronXL em um projeto .NET?

IronXL é distribuído como um pacote NuGet. Instale-o no Console do Gerenciador de Pacotes no Visual Studio:

Install-Package IronXl

Install-Package IronXl

Ou usando a CLI do .NET:

dotnet add package IronXl

dotnet add package IronXl

Após a instalação, adicione using IronXL; a qualquer arquivo que trabalhe com planilhas. O pacote tem como alvo o .NET Framework 4.6.2+, .NET Core 3.1+, .NET 5 até o .NET 10, e suporta ambientes de implantação Windows, Linux, macOS, Docker e Azure.

Não são necessárias dependências de tempo de execução adicionais ou instalação do Microsoft Office. IronXL lê e escreve arquivos XLSX usando seu próprio analisador e escritor, tornando-o adequado para implantações no lado do servidor e sem interface onde o Office não pode ser instalado.

Como você lida com a codificação CSV durante a conversão?

Muitos arquivos CSV se originam de sistemas legados, bancos de dados internacionais ou exportações de terceiros que usam caracteres não ASCII. Manusear a codificação corretamente garante que caracteres especiais e texto internacional permaneçam intactos no arquivo XLSX resultante.

using IronXL;
using System.Text;

// Load CSV with explicit encoding specification
WorkBook workbook = WorkBook.LoadCSV("international-data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",",
    encoding: Encoding.UTF8);

// Access the worksheet containing the encoded data
WorkSheet sheet = workbook.DefaultWorkSheet;

// Inspect a cell to verify encoding was preserved
string cellValue = sheet["A1"].StringValue;

// Save the converted Excel file
workbook.SaveAs("encoded-output.xlsx");

using IronXL;
using System.Text;

// Load CSV with explicit encoding specification
WorkBook workbook = WorkBook.LoadCSV("international-data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",",
    encoding: Encoding.UTF8);

// Access the worksheet containing the encoded data
WorkSheet sheet = workbook.DefaultWorkSheet;

// Inspect a cell to verify encoding was preserved
string cellValue = sheet["A1"].StringValue;

// Save the converted Excel file
workbook.SaveAs("encoded-output.xlsx");

Como você aplica formatação de células após a conversão de CSV?

Dados brutos de CSV não carregam informações de formatação. Após converter para XLSX, aplique formatos de números, fontes e cores de fundo para tornar a planilha legível e profissional.

using IronXL;
using IronXl.Styles;

// Load CSV data
WorkBook workbook = WorkBook.LoadCSV("sales-report.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

WorkSheet sheet = workbook.DefaultWorkSheet;

// Format the header row with bold text and background color
Range headerRow = sheet["A1:Z1"];
headerRow.Style.Font.Bold = true;
headerRow.Style.SetBackgroundColor("#4472C4");
headerRow.Style.Font.Color = "#FFFFFF";

// Apply currency format to a numeric column
Range priceColumn = sheet["C2:C100"];
priceColumn.Style.NumberFormat = "$#,##0.00";

// Auto-fit column widths for readability
sheet.AutoSizeColumn(0);
sheet.AutoSizeColumn(1);
sheet.AutoSizeColumn(2);

workbook.SaveAs("formatted-report.xlsx");

using IronXL;
using IronXl.Styles;

// Load CSV data
WorkBook workbook = WorkBook.LoadCSV("sales-report.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

WorkSheet sheet = workbook.DefaultWorkSheet;

// Format the header row with bold text and background color
Range headerRow = sheet["A1:Z1"];
headerRow.Style.Font.Bold = true;
headerRow.Style.SetBackgroundColor("#4472C4");
headerRow.Style.Font.Color = "#FFFFFF";

// Apply currency format to a numeric column
Range priceColumn = sheet["C2:C100"];
priceColumn.Style.NumberFormat = "$#,##0.00";

// Auto-fit column widths for readability
sheet.AutoSizeColumn(0);
sheet.AutoSizeColumn(1);
sheet.AutoSizeColumn(2);

workbook.SaveAs("formatted-report.xlsx");

IronXL expõe a formatação de células e de intervalo através da propriedade Style, que espelha as opções de formatação disponíveis na interface do Excel. Os formatos de número seguem a sintaxe de formato de número do Excel documentada pela Microsoft. O método SetBackgroundColor aceita strings de cores em formato hexadecimal, tornando simples a aplicação de cores de marca em relatórios gerados. Veja a referência completa da API de formatação de células para propriedades de estilo disponíveis.

Como você pode adicionar gráficos após converter dados CSV?

Uma vez que os dados CSV existam em uma pasta de trabalho do Excel, o IronXL permite criar gráficos diretamente a partir desses dados. Os gráficos transformam números brutos em insights visuais sem a necessidade de instalação do Microsoft Excel no servidor.

using IronXL;
using IronXl.Drawing.Charts;

// Load CSV and convert to Excel format
WorkBook workbook = WorkBook.LoadCSV("sales-data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

WorkSheet worksheet = workbook.DefaultWorkSheet;

// Create a column chart from the converted CSV data
IChart chart = worksheet.CreateChart(ChartType.Column, 10, 0, 25, 10);

// Add data series from the worksheet ranges
IChartSeries series = chart.AddSeries("A2:A10", "B2:B10");
series.Title = "Monthly Sales";

// Configure chart appearance
chart.SetTitle("Sales Performance");
chart.SetLegendPosition(LegendPosition.Bottom);

// Plot the chart and save the workbook
chart.Plot();
workbook.SaveAs("sales-with-chart.xlsx");

using IronXL;
using IronXl.Drawing.Charts;

// Load CSV and convert to Excel format
WorkBook workbook = WorkBook.LoadCSV("sales-data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

WorkSheet worksheet = workbook.DefaultWorkSheet;

// Create a column chart from the converted CSV data
IChart chart = worksheet.CreateChart(ChartType.Column, 10, 0, 25, 10);

// Add data series from the worksheet ranges
IChartSeries series = chart.AddSeries("A2:A10", "B2:B10");
series.Title = "Monthly Sales";

// Configure chart appearance
chart.SetTitle("Sales Performance");
chart.SetLegendPosition(LegendPosition.Bottom);

// Plot the chart and save the workbook
chart.Plot();
workbook.SaveAs("sales-with-chart.xlsx");

Como você converte CSV para um DataTable e depois para o Excel?

Para cenários que exigem manipulação de dados antes da exportação, converter dados CSV através de um DataTable oferece máxima flexibilidade. Essa abordagem permite que os desenvolvedores filtrem, transformem, classifiquem ou validem linhas durante o processo de conversão usando padrões de acesso a dados .NET padrão.

using IronXL;
using System.Data;

// Load CSV file into workbook
WorkBook sourceWorkbook = WorkBook.LoadCSV("input.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

// Convert worksheet to DataTable for manipulation
DataTable table = sourceWorkbook.DefaultWorkSheet.ToDataTable(true);

// Filter rows -- keep only rows where the third column value is greater than 100
DataRow[] filtered = table.Select("Column3 > 100");
DataTable filteredTable = filtered.Length > 0 ? filtered.CopyToDataTable() : table.Clone();

// Create new workbook from modified data
WorkBook outputWorkbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet outputSheet = outputWorkbook.CreateWorkSheet("Processed Data");

// Import filtered DataTable back into Excel
outputSheet.LoadFromDataTable(filteredTable, true);

// Save the final XLSX file
outputWorkbook.SaveAs("processed-output.xlsx");

using IronXL;
using System.Data;

// Load CSV file into workbook
WorkBook sourceWorkbook = WorkBook.LoadCSV("input.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

// Convert worksheet to DataTable for manipulation
DataTable table = sourceWorkbook.DefaultWorkSheet.ToDataTable(true);

// Filter rows -- keep only rows where the third column value is greater than 100
DataRow[] filtered = table.Select("Column3 > 100");
DataTable filteredTable = filtered.Length > 0 ? filtered.CopyToDataTable() : table.Clone();

// Create new workbook from modified data
WorkBook outputWorkbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet outputSheet = outputWorkbook.CreateWorkSheet("Processed Data");

// Import filtered DataTable back into Excel
outputSheet.LoadFromDataTable(filteredTable, true);

// Save the final XLSX file
outputWorkbook.SaveAs("processed-output.xlsx");

Como Salvar um Arquivo XLSX em um Stream em Vez de um Caminho de Arquivo?

Aplicações do lado do servidor muitas vezes precisam entregar arquivos Excel diretamente para respostas HTTP em vez de escrever arquivos temporários no disco. IronXL suporta salvar workbooks para MemoryStream para esse propósito.

using IronXL;
using System.IO;

// Load and convert CSV data
WorkBook workbook = WorkBook.LoadCSV("report-data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

WorkSheet sheet = workbook.DefaultWorkSheet;

// Save workbook to a memory stream instead of a file
using MemoryStream stream = new MemoryStream();
workbook.SaveAs(stream);

// Reset stream position for reading
stream.Position = 0;

// The stream is now ready to pass to an HTTP response, upload to cloud storage,
// or attach to an email. For ASP.NET Core:
// return File(stream, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "report.xlsx");

// Write bytes to verify stream contains XLSX data
byte[] xlsxBytes = stream.ToArray();
Console.WriteLine($"Generated XLSX size: {xlsxBytes.Length} bytes");

using IronXL;
using System.IO;

// Load and convert CSV data
WorkBook workbook = WorkBook.LoadCSV("report-data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

WorkSheet sheet = workbook.DefaultWorkSheet;

// Save workbook to a memory stream instead of a file
using MemoryStream stream = new MemoryStream();
workbook.SaveAs(stream);

// Reset stream position for reading
stream.Position = 0;

// The stream is now ready to pass to an HTTP response, upload to cloud storage,
// or attach to an email. For ASP.NET Core:
// return File(stream, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "report.xlsx");

// Write bytes to verify stream contains XLSX data
byte[] xlsxBytes = stream.ToArray();
Console.WriteLine($"Generated XLSX size: {xlsxBytes.Length} bytes");

Salvar em um stream evita operações de leitura/escrita de disco e elimina a necessidade de limpar arquivos temporários. Este padrão é amplamente utilizado em pontos de download de arquivo do ASP.NET Core onde o XLSX é gerado sob demanda. A sobrecarga SaveAs(Stream) escreve um arquivo XLSX completo e válido para qualquer instância de stream gravável.

Como Trabalhar com Múltiplas Planilhas em um Livro Convertido?

Um único livro XLSX pode conter múltiplas planilhas. Após converter um arquivo CSV, o livro retém uma folha por padrão. Folhas adicionais podem ser criadas programaticamente para organizar dados relacionados.

using IronXL;

// Load primary CSV data
WorkBook workbook = WorkBook.LoadCSV("quarterly-data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

// Rename the default sheet created from the CSV
WorkSheet q1Sheet = workbook.DefaultWorkSheet;
q1Sheet.Name = "Q1 Data";

// Create additional worksheets for summary information
WorkSheet summarySheet = workbook.CreateWorkSheet("Summary");

// Write summary headers and formulas
summarySheet["A1"].Value = "Total Records";
summarySheet["B1"].Formula = $"=COUNTA('{q1Sheet.Name}'!A:A)-1";

summarySheet["A2"].Value = "Data Sheet";
summarySheet["B2"].Value = q1Sheet.Name;

// Save the multi-sheet workbook
workbook.SaveAs("multi-sheet-report.xlsx");

using IronXL;

// Load primary CSV data
WorkBook workbook = WorkBook.LoadCSV("quarterly-data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

// Rename the default sheet created from the CSV
WorkSheet q1Sheet = workbook.DefaultWorkSheet;
q1Sheet.Name = "Q1 Data";

// Create additional worksheets for summary information
WorkSheet summarySheet = workbook.CreateWorkSheet("Summary");

// Write summary headers and formulas
summarySheet["A1"].Value = "Total Records";
summarySheet["B1"].Formula = $"=COUNTA('{q1Sheet.Name}'!A:A)-1";

summarySheet["A2"].Value = "Data Sheet";
summarySheet["B2"].Value = q1Sheet.Name;

// Save the multi-sheet workbook
workbook.SaveAs("multi-sheet-report.xlsx");

O método CreateWorkSheet adiciona uma nova folha vazia ao workbook. As folhas são acessíveis por nome ou por índice através de workbook.WorkSheets. Referências de fórmula entre folhas usam a notação padrão do Excel 'SheetName'!CellRef. Para mais informações sobre operações em múltiplas folhas, veja o guia de múltiplas planilhas do IronXL.

Quais são os seus próximos passos?

Converter arquivos CSV para XLSX em C# com IronXL requer apenas algumas linhas de código e produz um livro Excel totalmente compatível sem qualquer dependência do Microsoft Office. Os exemplos acima cobrem todo o fluxo de trabalho -- desde o carregamento básico de CSV e salvamento até o manuseio de codificação, formatação de células, criação de gráficos, integração de DataTable, saída de stream e livros com múltiplas folhas.

Principais funcionalidades abordadas neste guia:

• Conversão básica de CSV para XLSX com WorkBook.LoadCSV e SaveAs.
• Especificação de codificação para conjuntos de caracteres internacionais
• Formatação de células e intervalos aplicada após a conversão
• Criação de gráficos incorporados diretamente no arquivo XLSX
• Round-trip de DataTable para dados filtrados e transformados
• Saída de MemoryStream para entrega de arquivos do lado do servidor
• Construção de livro com múltiplas folhas a partir de uma única fonte CSV

IronXL suporta implantações em Windows, Linux, macOS, Docker, e Azure através de .NET Framework, .NET Core, e .NET 5 até 10. Para explorar mais capacidades, reveja a documentação do IronXL, navegue pela referência de objeto da API do Excel, ou confira os guias de como-fazer do IronXL para tópicos como ler arquivos Excel, mesclar células, e aplicar fórmulas. Baixe uma avaliação gratuita para testar todos os recursos em um ambiente de desenvolvimento, ou compre uma licença para implantação em produção.

!{--010011000100100101000010010100100100000101010010010110010101111101000111010001010101010100010111110101001101010100010000010101001001010100010001010100010001011111010101110100100 101010100010010000101111101010000010100100111101000100010101010100001101010100010111110101010001010010010010010010010100000101001100010111110100001001001100010011110100001101001011--}