Como ler arquivos CSV com vírgulas em C#

Por que desenvolvedores .NET precisam de uma solução CSV melhor?

Arquivos CSV impulsionam a troca de dados em incontáveis aplicações .NET. Desde relatórios financeiros até sistemas de inventário, você tem a liberdade de criar arquivos CSV programaticamente em apenas algumas linhas de código. Enquanto bibliotecas como CsvHelper cobrem operações básicas de CSV, desenvolvedores modernos enfrentam cenários complexos: converter livros de Excel com fórmulas, preservar tipos de dados durante a exportação e lidar com fluxos de trabalho de planilhas de nível empresarial. IronXL aborda esses desafios combinando robustez na escrita de CSV com funcionalidade abrangente de Excel em uma biblioteca única, sem dependências, que segue os padrões RFC 4180.

Isso a torna ideal para desenvolvedores que estão construindo um escritor CSV personalizado for .NET ou um analisador CSV for .NET que suporta múltiplas colunas, funcionalidade específica de linha que afeta apenas a linha sendo processada, e separadores inferidos automaticamente.

Começando com IronXL

Instalar o IronXL leva segundos através do Gerenciador de Pacotes NuGet:

Install-Package IronXl.Excel

Uma vez instalado, adicione o namespace IronXL para começar a escrever arquivos CSV e trabalhar com valores separados de forma eficiente:

using IronXL;
class Program
{
    static void Main(string[] args)
    {
        // Create a new workbook and worksheet
        WorkBook workBook = WorkBook.Create();
        WorkSheet workSheet = workBook.CreateWorkSheet("data");
        // Add headers
        workSheet["A1"].Value = "Product";
        workSheet["B1"].Value = "Quantity";
        workSheet["C1"].Value = "Price";
        // Add data
        workSheet["A2"].Value = "Widget";
        workSheet["B2"].Value = 100;
        workSheet["C2"].Value = 19.99;
        // Save as CSV with comma delimiter
        workBook.SaveAsCsv("inventory.csv", ",");
    }
}

using IronXL;
class Program
{
    static void Main(string[] args)
    {
        // Create a new workbook and worksheet
        WorkBook workBook = WorkBook.Create();
        WorkSheet workSheet = workBook.CreateWorkSheet("data");
        // Add headers
        workSheet["A1"].Value = "Product";
        workSheet["B1"].Value = "Quantity";
        workSheet["C1"].Value = "Price";
        // Add data
        workSheet["A2"].Value = "Widget";
        workSheet["B2"].Value = 100;
        workSheet["C2"].Value = 19.99;
        // Save as CSV with comma delimiter
        workBook.SaveAsCsv("inventory.csv", ",");
    }
}

Este simples programa de teste de console mostra como escrever o conteúdo CSV diretamente do seu código C#, criando um objeto Workbook que contém nossos dados. O método SaveAsCsv usa um separador padrão (vírgula), mas permite que você defina opcionalmente um sep para diferentes localidades; isso é especialmente útil ao lidar com um separador decimal ou caractere alternativo de separação de coluna. Internamente, sep lida com a alocação de matriz para o buffer de saída. O parâmetro sep mencionado anteriormente permite que você defina esse caractere.

Também demonstramos como fornecer um ponto de entrada estático e mostramos como fazer uma gestão eficiente de memória usando um pool de recursos estaticamente definido, permitindo alto desempenho em várias linhas.

Técnicas avançadas de criação de arquivos CSV

// Load an Excel file with formulas and formatting
WorkBook workBook = WorkBook.Load("financial_report.xlsx");
// IronXL evaluates formulas before export
workBook.EvaluateAll();
// Export to CSV - each worksheet creates a separate CSV file
workBook.SaveAsCsv("report.csv", ",");
// Creates: report.Sheet1.csv, report.Sheet2.csv, etc.

// Load an Excel file with formulas and formatting
WorkBook workBook = WorkBook.Load("financial_report.xlsx");
// IronXL evaluates formulas before export
workBook.EvaluateAll();
// Export to CSV - each worksheet creates a separate CSV file
workBook.SaveAsCsv("report.csv", ",");
// Creates: report.Sheet1.csv, report.Sheet2.csv, etc.

// Assume dataTable contains query results
DataTable dataTable = GetSalesData();
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("sales");
// Import DataTable directly
var row = 1;
foreach (var dataRow in dataTable.Rows)
{
    for (var col = 0; col < dataTable.Columns.Count; col++)
    {
        workSheet.SetCellValue(row, col, dataRow[col].ToString());
    }
    row++;
}
// Export with custom delimiter if needed
workBook.SaveAsCsv("sales_data.csv", ";");

// Assume dataTable contains query results
DataTable dataTable = GetSalesData();
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("sales");
// Import DataTable directly
var row = 1;
foreach (var dataRow in dataTable.Rows)
{
    for (var col = 0; col < dataTable.Columns.Count; col++)
    {
        workSheet.SetCellValue(row, col, dataRow[col].ToString());
    }
    row++;
}
// Export with custom delimiter if needed
workBook.SaveAsCsv("sales_data.csv", ";");

IronXL vs CsvHelper: Comparação Lado a Lado para Escrita de Arquivos CSV

Considere este cenário de exportação de dados de funcionários, demonstrando fluxos de trabalho de análise e escrita de CSV.

Implementação CsvHelper:

using (var writer = new StreamWriter("employees.csv"))
using (var csv = new CsvWriter(writer, CultureInfo.InvariantCulture))
{
    csv.WriteRecords(employees);
}

using (var writer = new StreamWriter("employees.csv"))
using (var csv = new CsvWriter(writer, CultureInfo.InvariantCulture))
{
    csv.WriteRecords(employees);
}

Implementação IronXL:

WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("employees");
// Add data with automatic type handling
int rowIndex = 1;
foreach (var emp in employees)
{
    workSheet[$"A{rowIndex}"].Value = emp.Name;
    workSheet[$"B{rowIndex}"].Value = emp.Salary;
    workSheet[$"C{rowIndex}"].Value = emp.StartDate;
    rowIndex++;
}
workBook.SaveAsCsv("employees.csv", ",");

WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("employees");
// Add data with automatic type handling
int rowIndex = 1;
foreach (var emp in employees)
{
    workSheet[$"A{rowIndex}"].Value = emp.Name;
    workSheet[$"B{rowIndex}"].Value = emp.Salary;
    workSheet[$"C{rowIndex}"].Value = emp.StartDate;
    rowIndex++;
}
workBook.SaveAsCsv("employees.csv", ",");

Enquanto CsvHelper lida eficientemente com operações de colunas de escrita simples, IronXL oferece a flexibilidade de trabalhar com múltiplas linhas, strings interpoladas e cenários de geração de código dinâmico e até mesmo permitir otimizações de baixo nível com construtos como ref struct link.

Os desenvolvedores podem enumerar linhas que correspondem a critérios específicos, gerenciar separadores padrão inferidos automaticamente, ou até mesmo testar com programas simples de console que expõem funcionalidade específica de linha e apenas a chave de cada entrada para depuração.

Recursos Empresariais e Melhores Práticas

O método SaveAsCsv do IronXL inclui capacidades de nível empresarial:

• Delimitadores personalizados: Suporte para vírgula, ponto e vírgula, tabulação ou qualquer caractere (o separador padrão pode ser substituído pelo separador sep)
• Opções de codificação: UTF-8, UTF-16 e codificações personalizadas
• Avaliação de fórmulas: Calcula fórmulas do Excel antes da exportação
• Suporte multiplataforma: Funciona no Windows, Linux e macOS

Os desenvolvedores também podem aplicar métodos de extensão para acessar múltiplas colunas para processamento eficiente ou escrever linhas CSV que se estendem por várias linhas quando o encapsulamento de texto é necessário.

Problemas Comuns e Soluções

Ao trabalhar com exportações de CSV, os desenvolvedores frequentemente encontram esses desafios:

• Caracteres especiais nos dados: O IronXL automaticamente escapa aspas, vírgulas e quebras de linha
• Manipulação de arquivos grandes: Use intervalos de planilha para processar dados em partes,
• Problemas de codificação: Especifique a codificação UTF-8 para caracteres internacionais
• Tipos de dados ausentes: IronXL preserva formatos numéricos e de data por padrão

Para solução de problemas detalhada, visite a documentação CSV do IronXL, referência API e recursos de suporte.

Comece a Construir Seu Escritor de CSV Hoje

IronXL transforma a escrita de CSV de um desafio de análise em uma operação direta. Combinando funcionalidade CSV com suporte a planilhas Excel, avaliação de fórmulas e manipulação automática de tipos, elimina a complexidade de gerenciar múltiplas bibliotecas ou conversões de dados manuais.

Pronto para simplificar seus fluxos de trabalho CSV? Inicie seu teste gratuito a partir de $liteLicense.