IRONSOFTWAREHOME
USANDO O IRONXL

Como escrever dados em um arquivo CSV em C#

Curtis Chau
Curtis Chau
Updated: 21 de abril de 2026

Este artigo explorará como escrever um arquivo CSV usando o IronXL.

Biblioteca IronXL

IronXL é uma biblioteca .NET Excel que oferece funcionalidades abrangentes para criar, ler e editar arquivos de planilha em aplicações C#. Ela se destaca em termos de desempenho e precisão de saída. Ela suporta vários formatos de arquivo de livro de planilha como XLS, XLSX, XLSM, CSV e TSV. Além disso, permite salvar ou exportar dados de arquivos Excel para formatos como CSV, JSON, HTML, Binário, Byte Array, DataSet ou DataTable.

Com IronXL, os desenvolvedores podem trabalhar perfeitamente com planilhas e intervalos de células, fornecendo uma abordagem elegante para manipulação de dados. Ela permite a edição fácil de fórmulas e facilita o recálculo de fórmulas dentro de uma planilha. Classificar dados com base em intervalo, coluna ou linha é direto. Você também pode modificar layouts congelando painéis, ajustando automaticamente linhas/colunas e adicionando/removendo linhas/colunas.

IronXL oferece capacidade de proteger arquivos Excel com senhas de usuário e definir permissões para edição. Além disso, ele fornece recursos para adicionar, remover e extrair imagens de planilhas do Excel. A biblioteca inclui uma ampla gama de funções do Excel, suportando diversos formatos de dados de células. Isso torna o IronXL uma das APIs mais intuitivas para trabalhar com arquivos do Excel.

Uma vantagem notável do IronXL é que ele não requer que o Microsoft Excel ou dependências do Office Interop sejam instalados na máquina. É uma solução independente que funciona em várias plataformas e é compatível com as versões .NET 7, 6 e 5. Também oferece suporte ao .NET Core 2 e 3, bem como à versão padrão 2. Para trabalhar com planilhas do Excel, o IronXL é compatível com o .NET Framework 4.5 e versões posteriores.

Criar um aplicativo de console

A versão mais recente do Visual Studio é recomendada para criar uma aplicação para começar. O Visual Studio é o IDE oficial para desenvolvimento em C#, e você deve tê-lo instalado. Você pode baixá-lo do site da Microsoft Visual Studio, se não estiver instalado.

Os passos a seguir criarão um novo projeto chamado "DemoApp".

  1. Abra o Visual Studio e clique em "Criar um novo projeto".

Como escrever dados em arquivo CSV em C#, Figura 1: Abra o Visual Studio Abrir o Visual Studio

  1. Selecione Aplicativo de Console e clique em 'Próximo'.

Como escrever dados em arquivo CSV em C#, Figura 2: Crie um novo projeto no Visual Studio Criar um novo projeto no Visual Studio

  1. Defina o nome do projeto

Como escrever dados em arquivo CSV em C#, Figura 3: Configure seu novo projeto Configure seu novo projeto

  1. Selecione a versão do .NET . Escolha a versão estável .NET 6.0.

Como escrever dados em arquivo CSV em C#, Figura 4: Seleção do .NET Framework Seleção do .NET Framework

Instalar a Biblioteca IronXL

Uma vez que o projeto é criado, a biblioteca IronXL precisa ser instalada no projeto para usá-la. Siga estes passos para instalá-lo.

  1. Abra o Gerenciador de Pacotes NuGet, seja pelo Solution Explorer ou ferramentas.

Como escrever dados em arquivo CSV em C#, Figura 5: Navegue até o Gerenciador de Pacotes NuGet Navegar até o Gerenciador de Pacotes NuGet

  1. Procure pela Biblioteca IronXL e selecione o projeto atual. Clique em instalar.

Como escrever dados em arquivo CSV em C#, Figura 6: Procure e instale o pacote IronXL na interface do Gerenciador de Pacotes NuGet Pesquisar e instalar o pacote IronXL na interface do Gerenciador de Pacotes NuGet

Adicione o seguinte namespace no topo do arquivo Program.cs:

using IronXL;

Create a New Workbook in C#

O IronXL fornece a funcionalidade para criar um livro em branco. Um livro é uma planilha que contém várias folhas de trabalho. Os dados são armazenados em células. CSV também se parece com uma planilha, mas com uma extensão de arquivo CSV.

// Creates a new instance of WorkBook Spreadsheet
WorkBook workBook = WorkBook.Create();

Agora, vamos criar uma planilha no WorkBook. Existem várias maneiras de criar uma folha de trabalho no livro.

// Adds a default sheet to the workbook
WorkSheet defaultSheet = workBook.DefaultWorkSheet;

// Creates a worksheet with the name "Sheet1"
WorkSheet sheet = workBook.CreateWorkSheet("Sheet1");

Se você deseja adicionar mais planilhas ao seu caderno existente, então use o método CreateWorkSheet.

Note: You can use WorkBook.LoadCSV method if the CSV file already exists. Você pode ver esta página de exemplo de código para carregar um arquivo CSV existente.

Escreva dados para o WorkSheet

Escrever arquivos CSV é fácil usando o IronXL. Ele fornece recursos do Excel para escrever dados em CSVs. Referências de célula podem ser usadas para adicionar os valores em locais especificados. Aqui, estou prestes a adicionar alguns registros de alguns funcionários usando um loop foreach.

// Initialize an array of employee names
string[] employeeNames = { "John", "Peter", "Harry", "Kevin", "Brian" };

// Starting row for data entry
int i = 2;

// Setting header titles for the columns
sheet["A1"].Value = "ID";
sheet["B1"].Value = "Name";
sheet["C1"].Value = "Salary";

// Populate each row with employee data
foreach (var employee in employeeNames)
{
    // Set values for ID, Name, and Salary
    sheet["A" + i].Value = i;
    sheet["B" + i].Value = employee;
    sheet["C" + i].Value = i * 1000;
    i++;
}

No exemplo de código acima, um array de employeeNames é criado, e a primeira linha é configurada com os cabeçalhos: ID, Nome, Salário. Uma variável i também é inicializada com o valor 2, que irá inserir os registros a partir da 2ª linha abaixo dos cabeçalhos. O loop foreach processa cada funcionário da lista e os adiciona à linha atual com valores de ID e salário. Antes que o loop seja concluído, i é incrementada para mover para a próxima linha para o próximo registro.

Salve os Dados em um arquivo CSV

A última etapa é salvar o arquivo CSV. O IronXL fornece o método SaveAsCsv para salvar o caderno como um arquivo CSV. O primeiro parâmetro deste método é o nome do arquivo CSV e o segundo é o delimitador.

// Save the modified workbook as a CSV file with a specified delimiter
workBook.SaveAsCsv("sample.csv", ",");

O código completo é o seguinte:

using System;
using IronXL;

class Program
{
    static void Main()
    {
        // Create a new workbook and worksheet
        WorkBook workBook = WorkBook.Create();
        WorkSheet sheet = workBook.CreateWorkSheet("Sheet1");

        // Initialize an array of employee names
        string[] employeeNames = { "John", "Peter", "Harry", "Kevin", "Brian" };

        // Starting row for data entry
        int i = 2;

        // Setting header titles for the columns
        sheet["A1"].Value = "ID";
        sheet["B1"].Value = "Name";
        sheet["C1"].Value = "Salary";

        // Populate each row with employee data
        foreach (var employee in employeeNames)
        {
            // Set values for ID, Name, and Salary
            sheet["A" + i].Value = i;
            sheet["B" + i].Value = employee;
            sheet["C" + i].Value = i * 1000;
            i++;
        }

        // Save the modified workbook as a CSV file with a specified delimiter
        workBook.SaveAsCsv("sample.csv", ",");
    }
}

Saída

Como escrever dados em arquivo CSV em C#, Figura 7: O arquivo CSV de saída O arquivo CSV de saída

Resumo

Este artigo apresenta uma abordagem simples para escrever um arquivo CSV usando IronXL em C#. O IronXL também fornece a facilidade de trabalhar com arquivos CSV existentes sem complicações. Ele também permite que você escreva arquivos CSV, crie novos arquivos Excel e escreva dados neles com uma sintaxe simples. O IronXL também pode ser usado para ler e escrever arquivos Excel sem o Microsoft Office instalado. Para conversão entre diferentes formatos de planilha, você pode ver esta página de exemplo de código.

O IronXL é gratuito para desenvolvimento e pode ser licenciado para uso comercial. Você também pode experimentar a versão de teste gratuita do IronXL para uso comercial.

Curtis Chau
Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.

...
Leia mais

Artigos relacionados

Key in blue circle

Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.

Your trial license will be sent to your email address

Sem limitações. 100% desbloqueado. Sem cartão de crédito.

bullet_checkedNão é necessário cartão de crédito nem criação de conta.Sem limitações. 100% desbloqueado. Sem cartão de crédito.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Agende sua demonstração ao vivo gratuita.
Booking Badge

Aprovado por milhões de engenheiros em todo o mundo.

Logotipos dos clientes da Iron Software
Agende sua consulta sem compromisso.
Preencha o formulário abaixo ou envie um e-mail para sales@ironsoftware.com
Os seus dados serão sempre mantidos em sigilo.
Aprovado por milhões de engenheiros em todo o mundo.
Logotipos dos clientes da Iron Software
Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.
Não é necessário cartão de crédito nem criação de conta.