Como exportar um `DataTable` para CSV em C#

Quais Recursos a Biblioteca IronXL Oferece?

Documentos do Microsoft Excel podem ser lidos e convertidos em arquivos CSV usando a biblioteca C# IronXL .NET. IronXL é uma biblioteca de software .NET autônoma que pode ler uma variedade de formatos de planilha. Não depende de Microsoft.Office.Interop.Excel nem exige a instalação do Microsoft Excel.

Com a ajuda da API C# amigável do IronXL, você pode rapidamente ler, modificar e criar arquivos de planilha Excel no ambiente .NET. .NET Core, .NET Framework, Xamarin, Mobile, Linux, macOS e Azure são totalmente suportados pelo IronXL.

• As principais bibliotecas de planilhas Excel .NET Core e .NET Framework para C# incluem IronXL.
• Praticamente todos os Frameworks .NET são suportados, incluindo Aplicações de Console, Windows Forms e Aplicações Web.
• IronXL opera em sistemas operacionais Windows, Linux e macOS.
• IronXL torna a leitura de arquivos Excel simples e rápida.
• IronXL suporta múltiplos formatos de Excel: arquivos XLSX, XLS, CSV, TSV, XLST e XLSM.
• IronXL exporta arquivos para vários formatos, incluindo XLS, CSV, TSV, JSON e XML.
• IronXL gera cálculos de Excel e suporta fórmulas.
• IronXL suporta formatos de dados de colunas de Excel incluindo texto, números, datas, moedas e percentuais.

Para mais detalhes, visite a Visão Geral da Documentação do IronXL.

Como faço para criar um novo projeto no Visual Studio?

No Visual Studio, um projeto .NET deve ser criado antes que o framework IronXL possa ser usado. Qualquer edição do Visual Studio funcionará, mas a mais recente é recomendada. Dependendo das suas necessidades, você pode construir uma aplicação Windows Forms ou diferentes modelos de projeto. Para manter as coisas simples, este tutorial usará a Aplicação de Console.

Crie um novo projeto no Visual Studio.

Depois disso, insira o nome e o local do projeto.

Configure o novo projeto

Em seguida, selecione a seguinte estrutura. .NET Core 6 será usado neste projeto.

Selecione uma versão do .NET Framework

O arquivo program.cs será aberto após a aplicação gerar a solução para que você possa inserir o código do programa e construir/executar a aplicação.

O projeto de Aplicação de Console recém-criado

A biblioteca pode então ser adicionada e usada para avaliar o código. Para outros tipos de projetos como aplicações .NET MAUI ou projetos VB.NET, o processo é similar, mas com considerações específicas do framework.

Como Instalo a Biblioteca IronXL?

Existem quatro métodos para baixar e instalar a Biblioteca IronXL.

Os quais são:

• Instalando via Visual Studio
• Instalando usando o Console do Gerenciador de Pacotes do Visual Studio
• Baixando diretamente do site NuGet Baixando diretamente do site IronXL

Como Exporto um DataTable para Arquivo CSV?

DataTables pode ser facilmente e rapidamente exportado para arquivos CSV usando IronXL. Ele ajuda a escrever dados em novos arquivos CSV com suporte para delimitadores personalizados e opções de codificação.

Primeiro, como mostrado na imagem de código abaixo, o namespace IronXL deve ser incluído para usar as classes e métodos do IronXL.

Adicione namespaces comuns

Arquivos Excel podem ser criados usando IronXL, que então os transforma em WorkBook objetos. Em seguida, realize várias operações nesses objetos. O código de exemplo abaixo irá criar um arquivo Excel convertendo um DataTable em uma planilha Excel.

using IronXL;
using System.Data;

// Entry point of the application
static void Main(string[] args)
{
    // Specify the file path for the CSV file output
    ExportToExcel("H:\\test.csv");
}

// Exports the DataTable to an Excel file and saves it as CSV
public static void ExportToExcel(string filepath)
{
    // Create a DataTable and add columns and rows
    DataTable table = new DataTable();
    table.Columns.Add("DataSet_Fruits", typeof(string));
    table.Rows.Add("Apple");
    table.Rows.Add("Orange");
    table.Rows.Add("Strawberry");
    table.Rows.Add("Grapes");
    table.Rows.Add("Watermelon");
    table.Rows.Add("Bananas");
    table.Rows.Add("Lemons");

    // Create a new WorkBook and add the DataTable data to it
    WorkBook wb = WorkBook.Create(ExcelFileFormat.XLS);
    var writer = wb.DefaultWorkSheet;
    int rowCount = 1;
    foreach (DataRow row in table.Rows)
    {
        // Write each item from the DataTable into the worksheet starting from cell A1
        writer["A" + (rowCount)].Value = row[0].ToString();
        rowCount++;
    }
    // Save the workbook as a CSV file with a specified delimiter
    wb.SaveAsCsv(filepath, ";");
}

using IronXL;
using System.Data;

// Entry point of the application
static void Main(string[] args)
{
    // Specify the file path for the CSV file output
    ExportToExcel("H:\\test.csv");
}

// Exports the DataTable to an Excel file and saves it as CSV
public static void ExportToExcel(string filepath)
{
    // Create a DataTable and add columns and rows
    DataTable table = new DataTable();
    table.Columns.Add("DataSet_Fruits", typeof(string));
    table.Rows.Add("Apple");
    table.Rows.Add("Orange");
    table.Rows.Add("Strawberry");
    table.Rows.Add("Grapes");
    table.Rows.Add("Watermelon");
    table.Rows.Add("Bananas");
    table.Rows.Add("Lemons");

    // Create a new WorkBook and add the DataTable data to it
    WorkBook wb = WorkBook.Create(ExcelFileFormat.XLS);
    var writer = wb.DefaultWorkSheet;
    int rowCount = 1;
    foreach (DataRow row in table.Rows)
    {
        // Write each item from the DataTable into the worksheet starting from cell A1
        writer["A" + (rowCount)].Value = row[0].ToString();
        rowCount++;
    }
    // Save the workbook as a CSV file with a specified delimiter
    wb.SaveAsCsv(filepath, ";");
}

O código acima exporta o DataTable para um arquivo Excel. Os títulos das colunas são criados uma vez que um DataTable é criado. Em seguida, adicione as linhas uma de cada vez após estabelecer a primeira coluna. O objeto WorkBook é criado após adicionar as colunas e linhas ao objeto DataTable para armazenar esses dados. O objeto WorkSheet é então construído, sendo adicionado ao objeto WorkBook.

Cada valor do DataTable é lido e adicionado usando um loop foreach antes de adicionar o valor ao WorkSheet. Após todos os valores terem sido adicionados à planilha, o método SaveAsCsv os salva em um arquivo CSV. Você pode especificar tanto o delimitador quanto a localização do arquivo como parâmetros.

Para cenários mais complexos, você pode querer exportar múltiplas DataTables como planilhas diferentes ou trabalhar com DataSets para uma organização de dados mais estruturada.

// Export with custom delimiter and encoding
public static void ExportToCSVWithOptions(DataTable dataTable, string filepath)
{
    // Create workbook from DataTable
    WorkBook wb = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet ws = wb.CreateWorkSheet("DataExport");

    // Add headers
    for (int i = 0; i < dataTable.Columns.Count; i++)
    {
        ws[$"{(char)('A' + i)}1"].Value = dataTable.Columns[i].ColumnName;
    }

    // Add data rows
    for (int row = 0; row < dataTable.Rows.Count; row++)
    {
        for (int col = 0; col < dataTable.Columns.Count; col++)
        {
            ws[$"{(char)('A' + col)}{row + 2}"].Value = dataTable.Rows[row][col];
        }
    }

    // Save with custom delimiter (comma) and UTF-8 encoding
    wb.SaveAsCsv(filepath, ",", System.Text.Encoding.UTF8);
}

// Export with custom delimiter and encoding
public static void ExportToCSVWithOptions(DataTable dataTable, string filepath)
{
    // Create workbook from DataTable
    WorkBook wb = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet ws = wb.CreateWorkSheet("DataExport");

    // Add headers
    for (int i = 0; i < dataTable.Columns.Count; i++)
    {
        ws[$"{(char)('A' + i)}1"].Value = dataTable.Columns[i].ColumnName;
    }

    // Add data rows
    for (int row = 0; row < dataTable.Rows.Count; row++)
    {
        for (int col = 0; col < dataTable.Columns.Count; col++)
        {
            ws[$"{(char)('A' + col)}{row + 2}"].Value = dataTable.Rows[row][col];
        }
    }

    // Save with custom delimiter (comma) and UTF-8 encoding
    wb.SaveAsCsv(filepath, ",", System.Text.Encoding.UTF8);
}

Por que devo usar IronXL para Exportação CSV?

Uma das ferramentas Excel mais populares é o IronXL. Ele não depende de nenhuma outra biblioteca de fontes externas. É autônomo e não requer a instalação do Microsoft Excel. Opera em vários canais.

IronXL fornece uma solução completa para todas as tarefas relacionadas a documentos do Microsoft Excel a serem implementadas programaticamente. Você pode realizar cálculo de fórmula, classificação de strings ou números, cortar e anexar, buscar e substituir, mesclar e desmesclar, salvar arquivos, etc. Você também pode definir formatos de dados de célula juntamente com validar dados da planilha. Ele também suporta leitura e escrita de arquivos CSV e ajuda você a trabalhar como dados do Excel.

Benefícios adicionais incluem:

• Proteção por senha para exportações de dados sensíveis
• Otimização de performance para grandes conjuntos de dados
• Suporte para formatação condicional no Excel antes da exportação CSV
• Suporte a intervalos nomeados e tabelas nomeadas
• Preservação de hiperlinks em formatos suportados

O preço inicial do IronXL no lançamento é $799. Ele também oferece aos usuários a opção de pagar uma taxa de assinatura de um ano para assistência ao produto e atualizações. Por uma taxa adicional, IronXL oferece segurança para redistribuição irrestrita. Para pesquisar informações de preços mais aproximadas, por favor visite esta página de licenciamento.