USANDO O IRONXL

Tutorial passo a passo de como criar um arquivo CSV em C#

Curtis Chau
Curtis Chau
Updated: 19 de julho de 2026

Conteúdo do Corpo: Procurando como criar/escrever um novo formato de dados de arquivo CSV usando uma biblioteca C# .NET em uma Aplicação de Console? Se sim, então você está no lugar certo.

Este é um tutorial simples escrito para criar arquivos CSV de várias linhas (com cabeçalhos) a partir de strings usando a biblioteca IronXL C# .NET. O IronXL é a biblioteca .NET líder de mercado para manipulação de documentos como Excel, CSV e XLS sem qualquer configuração adicional do usuário.

Como posso criar e escrever arquivos CSV usando C#?

O método mais simples para gerar e editar arquivos CSV usando C# é seguir estas etapas simples:

  • Crie uma Aplicação de Console C# no Visual Studio.
  • Instale a biblioteca .NET do IronXL.
  • Crie um arquivo CSV a partir de outra fonte em duas linhas de código.

1. Iniciando um Novo Projeto no Visual Studio

Abra o ambiente de desenvolvimento integrado (IDE) do Visual Studio.

Vá ao menu Arquivo e selecione Aplicação de Console após escolher "Novo Projeto".

Digite o Nome do Projeto e a localização preferida do projeto na caixa de texto apropriada.

Como Criar Arquivo CSV em C# (Passo-a-Passo) Tutorial, Figura 1: Configurar Novo Projeto Configurar Novo Projeto

Clique no botão Avançar, selecione o .NET Framework necessário, como mostrado na captura de tela abaixo, e clique em Criar.

Como Criar Arquivo CSV em C# (Passo-a-Passo) Tutorial, Figura 2: Seleção de Framework de Destino Seleção do Framework Alvo

O arquivo program.cs será aberto.

Como Criar Arquivo CSV em C# (Passo-a-Passo) Tutorial, Figura 3: Program.cs Program.cs

2. Instale a Biblioteca IronXL C#

A biblioteca IronXL pode ser baixada e instalada de duas maneiras diferentes:

  • Usando o Gerenciador de Pacotes NuGet do Visual Studio
  • Usando a linha de comando do Visual Studio

2.1. Usando o Gerenciador de Pacotes NuGet do Visual Studio

A opção do Gerenciador de Pacotes NuGet está disponível no software Visual Studio para instalar o pacote diretamente na solução. A captura de tela abaixo mostra como abri-lo.

Como Criar Arquivo CSV em C# (Passo-a-Passo) Tutorial, Figura 4: Gerenciador de Pacotes NuGet Gerenciador de Pacotes NuGet

O recurso do Gerenciador de Pacotes NuGet proporciona uma área onde os usuários podem navegar e pesquisar pacotes disponíveis no site da NuGet. Digite "IronXL" no campo de pesquisa para encontrar a biblioteca do IronXL.

Como Criar Arquivo CSV em C# (Passo-a-Passo) Tutorial, Figura 5: Gerenciador de Pacotes NuGet Gerenciador de Pacotes NuGet

Nos pacotes vinculados à pesquisa na imagem acima, selecione a opção IronXL e instale o pacote na solução.

2.2. Usando a linha de comando do Visual Studio

No menu do Visual Studio, vá para Ferramentas, mova o cursor para Gerenciador de Pacotes NuGet e clique em Console do Gerenciador de Pacotes.

Como Criar Arquivo CSV em C# (Passo-a-Passo) Tutorial, Figura 6: Linha de Comando do Visual Studio Linha de Comando do Visual Studio

O Console do Gerenciador de Pacotes aparecerá na parte inferior da tela. Basta escrever o seguinte comando de código e pressionar enter, o IronXL instalará uma instância.

PM > Install-Package IronXL.Excel

3. Criando Arquivos CSV

Neste blog, existem dois métodos diferentes para criar um arquivo CSV usando o IronXL.

  1. Criar CSV a partir de um arquivo XLSX
  2. Crie um arquivo CSV ao criar um novo WorkBook e escrevendo dados

3.1. Criar CSV a partir de um arquivo XLSX

Para criar um arquivo CSV, o arquivo Excel deve conter alguns dados de exemplo.

Como Criar Arquivo CSV em C# (Passo-a-Passo) Tutorial, Figura 7: Arquivo Excel de Exemplo Arquivo Excel de Exemplo

Insira o código abaixo no arquivo program.cs aberto e execute o projeto.

using IronXL;

class Program
{
    static void Main()
    {
        // Load an existing Excel file
        WorkBook wb = WorkBook.Load("test.xlsx");

        // Save the loaded workbook as a CSV file
        wb.SaveAsCsv("Parsed CSV.csv");
    }
}

Após a execução ser concluída, um novo arquivo chamado Parsed CSV.csv será criado. Abra o arquivo usando seu aplicativo de planilha preferido.

Como Criar Arquivos CSV em C# - Figura 8: Dados CSV Dados CSV

3.2. Criar novo Workbook CSV Programaticamente

Este exemplo de código mostra como criar um arquivo CSV do zero usando o IronXL.

using IronXL;

class Program
{
    static void Main()
    {
        // Create a new workbook in XLSX format
        WorkBook xlsWorkbook = WorkBook.Create(ExcelFileFormat.XLSX);

        // Set metadata for the workbook
        xlsWorkbook.Metadata.Author = "IronXL";

        // Create a new worksheet in the workbook
        WorkSheet xlsSheet = xlsWorkbook.CreateWorkSheet("new_sheet");

        // Add data to cells in the worksheet
        xlsSheet["A1"].Value = "Hello";
        xlsSheet["B1"].Value = "World";
        xlsSheet["A2"].Value = "New CSV example output";
        xlsSheet["B2"].Value = "From Scratch";

        // Save the workbook as a CSV file
        xlsWorkbook.SaveAsCsv("NewCSVFile.csv");
    }
}

O código de exemplo acima primeiro cria um novo Workbook e então preenche as linhas e colunas do WorkBook com dados. Depois disso, ele salva o arquivo usando o método SaveAsCsv.

Como Criar Arquivo CSV em C# (Passo-a-Passo) Tutorial, Figura 9: Saída do Arquivo CSV Saída de Arquivo CSV

4. Conclusão

Este artigo demonstrou como criar um novo arquivo CSV usando a biblioteca C# .NET IronXL usando dois métodos diferentes.

Além disso, a biblioteca Excel do IronXL oferece os seguintes recursos:

Para mais informações sobre o IronXL, navegue nas páginas de Exemplos de Código. Baixe o IronXL e experimente grátis por 30 dias antes de comprar uma licença.

Compre o Iron Suite completo para obter o IronXL e outros quatro produtos pelo mesmo preço de duas licenças do IronXL.

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