Como Escrever CSV em C# .NET usando o IronXL

Qual método de instalação devo usar?

Se você ainda não instalou o IronXL, siga estas etapas:

• Abra o Visual Studio e selecione o menu Projeto.
• Clique em Gerenciar Pacotes NuGet.
• Procure por IronXl.Excel.
• Clique em Instalar.

E Se Eu Preferir a Linha de Comando?

Use o seguinte comando no Developer Command Prompt:

Install-Package IronXl.Excel

Onde posso encontrar mais recursos?

Quais dados meu livro deve conter?

Arquivos CSV (comma-separated values, ou valores separados por vírgula) são amplamente usados para troca de dados entre aplicações devido ao seu formato simples e compatibilidade universal. Quer seja exportando dados para análise, criando relatórios ou integrando com outros sistemas, o IronXL torna o processo simples.

Primeiro, crie um livro Excel contendo dados de amostra. Se precisar de ajuda para criar arquivos Excel programaticamente, visite nosso tutorial para criar arquivos Excel no .NET:

Figura 1 - Dados normais do Excel para serem exportados para CSV

Qual namespace devo importar?

Adicione o namespace IronXL para escrever arquivos CSV em C#:

using IronXL;

using IronXL;

Que código preciso para converter Excel para CSV?

O seguinte código C# demonstra o uso do método Load do objeto WorkBook para carregar um arquivo Excel, em seguida, o uso do método SaveAs para salvá-lo como CSV. Esta abordagem lida automaticamente com tipos de dados, caracteres especiais e formatação:

:path=/static-assets/excel/content-code-examples/how-to/csharp-write-to-csv-file-save.cs

using IronXL;

// Load the existing Excel workbook
WorkBook wb = WorkBook.Load("Normal_Excel_File.xlsx"); // Import .xls, .csv, or .tsv file

// Save the workbook as a CSV file with the worksheet name appended
wb.SaveAs("Excel_To_CSV.csv"); // Exported as: Excel_To_CSV.Sheet1.csv

Como posso salvar uma planilha específica em CSV?

Ao trabalhar com livros de várias planilhas, você pode exportar planilhas específicas. O IronXL fornece opções flexíveis para este cenário. Saiba mais sobre gerenciamento de planilhas em nossa documentação:

using IronXL;

// Load workbook and access specific worksheet
WorkBook workBook = WorkBook.Load("MultiSheet_Excel.xlsx");
WorkSheet sheet = workBook.GetWorkSheet("Sales_Data");

// Save only the specific worksheet as CSV
sheet.SaveAsCsv("Sales_Data_Export.csv");

// Alternatively, save with custom delimiter
sheet.SaveAsCsv("Sales_Data_Tab.tsv", delimiter: "\t");

using IronXL;

// Load workbook and access specific worksheet
WorkBook workBook = WorkBook.Load("MultiSheet_Excel.xlsx");
WorkSheet sheet = workBook.GetWorkSheet("Sales_Data");

// Save only the specific worksheet as CSV
sheet.SaveAsCsv("Sales_Data_Export.csv");

// Alternatively, save with custom delimiter
sheet.SaveAsCsv("Sales_Data_Tab.tsv", delimiter: "\t");

Como é a saída do CSV?

O arquivo CSV de saída aparece da seguinte forma quando aberto em um editor de texto. Observe como o IronXL formata corretamente os dados com vírgulas como delimitadores e lida com campos de texto que contêm caracteres especiais:

Figura 2 - Arquivo CSV de saída

Como lido com várias planilhas?

Quando seu arquivo Excel contém várias planilhas, o IronXL oferece várias abordagens para exportação em CSV. Explore mais sobre como converter tipos de arquivos de planilhas em nosso guia completo:

using IronXL;
using System;

// Load workbook with multiple sheets
WorkBook workBook = WorkBook.Load("MultipleSheets.xlsx");

// Method 1: Export all sheets to separate CSV files
foreach (WorkSheet sheet in workBook.WorkSheets)
{
    string fileName = $"{sheet.Name}_Export.csv";
    sheet.SaveAsCsv(fileName);
    Console.WriteLine($"Exported {sheet.Name} to {fileName}");
}

// Method 2: Combine all sheets into one CSV
var combinedData = workBook.GetWorkSheet(0);
for (int i = 1; i < workBook.WorkSheets.Count; i++)
{
    var currentSheet = workBook.GetWorkSheet(i);
    // Add logic to append data from currentSheet to combinedData
}
combinedData.SaveAsCsv("Combined_Output.csv");

using IronXL;
using System;

// Load workbook with multiple sheets
WorkBook workBook = WorkBook.Load("MultipleSheets.xlsx");

// Method 1: Export all sheets to separate CSV files
foreach (WorkSheet sheet in workBook.WorkSheets)
{
    string fileName = $"{sheet.Name}_Export.csv";
    sheet.SaveAsCsv(fileName);
    Console.WriteLine($"Exported {sheet.Name} to {fileName}");
}

// Method 2: Combine all sheets into one CSV
var combinedData = workBook.GetWorkSheet(0);
for (int i = 1; i < workBook.WorkSheets.Count; i++)
{
    var currentSheet = workBook.GetWorkSheet(i);
    // Add logic to append data from currentSheet to combinedData
}
combinedData.SaveAsCsv("Combined_Output.csv");

E quanto às considerações de desempenho?

Para arquivos Excel grandes, o IronXL fornece capacidades de streaming eficientes que minimizam o uso de memória. Ao trabalhar com conjuntos de dados substanciais, use os métodos otimizados do IronXL. Veja nosso guia sobre como exportar dados para vários formatos para cenários avançados.

Posso trabalhar com DataTables?

O IronXL se integra perfeitamente com a estrutura DataTable do .NET, facilitando a exportação de dados de bancos de dados ou coleções em memória. Veja nosso tutorial sobre como converter DataTable para CSV:

using IronXL;
using System.Data;

// Create a DataTable with sample data
DataTable dataTable = new DataTable();
dataTable.Columns.Add("ID", typeof(int));
dataTable.Columns.Add("Name", typeof(string));
dataTable.Columns.Add("Price", typeof(decimal));

// Add sample rows
dataTable.Rows.Add(1, "Product A", 29.99m);
dataTable.Rows.Add(2, "Product B", 49.99m);

// Convert DataTable to WorkSheet
WorkBook workBook = WorkBook.Create();
WorkSheet sheet = workBook.CreateWorkSheet("Products");
sheet.InsertDataTable(dataTable, "A1");

// Save as CSV
workBook.SaveAsCsv("Products.csv");

using IronXL;
using System.Data;

// Create a DataTable with sample data
DataTable dataTable = new DataTable();
dataTable.Columns.Add("ID", typeof(int));
dataTable.Columns.Add("Name", typeof(string));
dataTable.Columns.Add("Price", typeof(decimal));

// Add sample rows
dataTable.Rows.Add(1, "Product A", 29.99m);
dataTable.Rows.Add(2, "Product B", 49.99m);

// Convert DataTable to WorkSheet
WorkBook workBook = WorkBook.Create();
WorkSheet sheet = workBook.CreateWorkSheet("Products");
sheet.InsertDataTable(dataTable, "A1");

// Save as CSV
workBook.SaveAsCsv("Products.csv");

Como configuro o licenciamento?

Antes de implementar sua solução de exportação CSV, configure corretamente sua licença do IronXL. Visite nosso guia sobre uso de chaves de licença para saber como aplicar licenças em diferentes ambientes.

---

Acesso rápido à biblioteca

### Documentação de Referência da API IronXL

Learn more and share how to merge, unmerge, and work with cells in Excel spreadsheets using the Documentação de Referência da API IronXL. For detailed method signatures and additional CSV export options, consult our [API Reference](https://ironsoftware.com/csharp/excel/object-reference/api/).

Documentação de Referência da API IronXL