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, ";");
}

Imports IronXL
Imports System.Data

' Entry point of the application
Shared Sub Main(ByVal args() As String)
	' Specify the file path for the CSV file output
	ExportToExcel("H:\test.csv")
End Sub

' Exports the DataTable to an Excel file and saves it as CSV
Public Shared Sub ExportToExcel(ByVal filepath As String)
	' Create a DataTable and add columns and rows
	Dim table As New DataTable()
	table.Columns.Add("DataSet_Fruits", GetType(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
	Dim wb As WorkBook = WorkBook.Create(ExcelFileFormat.XLS)
	Dim writer = wb.DefaultWorkSheet
	Dim rowCount As Integer = 1
	For Each row As DataRow In table.Rows
		' Write each item from the DataTable into the worksheet starting from cell A1
		writer("A" & (rowCount)).Value = row(0).ToString()
		rowCount += 1
	Next row
	' Save the workbook as a CSV file with a specified delimiter
	wb.SaveAsCsv(filepath, ";")
End Sub

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);
}

Imports System.Text

' Export with custom delimiter and encoding
Public Shared Sub ExportToCSVWithOptions(dataTable As DataTable, filepath As String)
    ' Create workbook from DataTable
    Dim wb As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
    Dim ws As WorkSheet = wb.CreateWorkSheet("DataExport")

    ' Add headers
    For i As Integer = 0 To dataTable.Columns.Count - 1
        ws($"{ChrW(AscW("A"c) + i)}1").Value = dataTable.Columns(i).ColumnName
    Next

    ' Add data rows
    For row As Integer = 0 To dataTable.Rows.Count - 1
        For col As Integer = 0 To dataTable.Columns.Count - 1
            ws($"{ChrW(AscW("A"c) + col)}{row + 2}").Value = dataTable.Rows(row)(col)
        Next
    Next

    ' Save with custom delimiter (comma) and UTF-8 encoding
    wb.SaveAsCsv(filepath, ",", Encoding.UTF8)
End Sub

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.