Tutorial passo a passo de análise sintática C# de CSV

Devo usar o Gerenciador de Pacotes NuGet do Visual Studio?

A interface do usuário do Gerenciador de Pacotes NuGet está disponível no Visual Studio para instalar o pacote diretamente no projeto. Este método é particularmente útil para desenvolvedores que preferem interfaces visuais e querem ver detalhes do pacote antes da instalação. A captura de tela abaixo mostra como abri-lo.

Access the NuGet Package Manager in Visual Studio by navigating to Tools > NuGet Package Manager > Manage NuGet Packages for Solution

A interface do Gerenciador de Pacotes fornece um recurso de Navegação que exibe uma lista de bibliotecas de pacotes disponíveis no site NuGet. Digite "IronXL" como mostrado na captura de tela abaixo para encontrar o pacote IronXL. Você também pode explorar recursos relacionados à manipulação de Excel que o IronXL oferece.

O Gerenciador de Pacotes NuGet no Visual Studio exibindo a biblioteca IronXl.Excel, que permite aos desenvolvedores ler, gerar e editar arquivos Excel em aplicações .NET. O pacote é mostrado com 250 mil downloads e versão 2022.9.9454 pronta para instalação

Selecione o pacote IronXl.Excel e clique no botão Instalar para adicioná-lo ao projeto. O processo de instalação lidará automaticamente com todas as dependências e configurará seu projeto para manipulação de arquivos Excel.

Quando devo usar a Linha de Comando do Visual Studio?

No menu do Visual Studio, vá para Ferramentas > Gerenciador de Pacotes NuGet > clique em Console do Gerenciador de Pacotes. Este método é preferido por desenvolvedores que estão confortáveis com interfaces de linha de comando ou precisam automatizar o processo de instalação em scripts de build.

Abrindo o Console do Gerenciador de Pacotes NuGet no Visual Studio para instalar bibliotecas de análise CSV

O Console do Gerenciador de Pacotes aparecerá na parte inferior da tela. Digite o seguinte comando e pressione enter. IronXL será instalado. Este método é particularmente útil quando você precisa instalar versões específicas ou quando está trabalhando com scripts de implantação para Azure ou ambientes AWS.

Install-Package IronXl.Excel

O Console do Gerenciador de Pacotes exibe a instalação bem-sucedida da versão 2022.11.10251 do IronXl.Excel, mostrando o processo de restauração do pacote e confirmações de download do repositório NuGet

Como Eu Converto um Arquivo XLSX para CSV?

Abra o Microsoft Excel e crie um novo arquivo XLSX. Preencha suas linhas e colunas com alguns dados fictícios. Para cenários de produção, talvez você queira criar arquivos Excel programaticamente usando o IronXL. A imagem abaixo mostra o arquivo usado para todas as conversões neste tutorial.

Figura 6: Dados de exemplo do Excel mostrando uma estrutura básica de inventário que será usada para demonstrar a análise de CSV em C#

Depois que você tiver seu arquivo pronto, escreva o código de exemplo a seguir e execute o programa. IronXL lida com toda a análise complexa internamente, incluindo tratamento adequado de caracteres especiais e tipos de dados:

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLSX file into a WorkBook object
        // The Load method automatically detects the file format
        WorkBook wb = WorkBook.Load("test.xlsx");

        // Save the WorkBook as a CSV file
        // This method handles all formatting and conversion automatically
        wb.SaveAsCsv("Parsed CSV.csv");

        // Optional: Save with custom delimiter
        // wb.SaveAsCsv("Parsed CSV.csv", delimiter: ";");
    }
}

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLSX file into a WorkBook object
        // The Load method automatically detects the file format
        WorkBook wb = WorkBook.Load("test.xlsx");

        // Save the WorkBook as a CSV file
        // This method handles all formatting and conversion automatically
        wb.SaveAsCsv("Parsed CSV.csv");

        // Optional: Save with custom delimiter
        // wb.SaveAsCsv("Parsed CSV.csv", delimiter: ";");
    }
}

Após a execução estar completa, um novo arquivo chamado Parsed CSV.csv será criado. Você pode ler arquivos CSV em qualquer editor ou leitor que preferir. Você também pode importar os dados CSV de volta para o Excel para mais manipulação. A imagem abaixo mostra a saída do comando acima — nossos dados CSV gerados. No arquivo de saída, aspas duplas representam valores em negrito.

Figura 7: A saída CSV gerada pelo método SaveAsCsv, exibindo os dados do Excel convertidos em formato separado por vírgulas

Quais são os Passos para Converter Arquivos XLS para CSV?

Neste exemplo, veremos como converter arquivos XLS em formato CSV. O processo é idêntico à conversão de XLSX, demonstrando a versatilidade do IronXL em lidar com diferentes formatos de arquivos Excel.

Primeiro, vamos criar um exemplo de arquivo XLS que podemos converter para o formato CSV. Observe que XLS é um formato mais antigo do Excel, mas o IronXL lida com ele perfeitamente junto com formatos modernos:

Figura 8: Um arquivo Excel de exemplo demonstrando a estrutura de dados de inventário com cálculos automáticos, que pode ser analisado usando bibliotecas CSV em C#

Em seguida, executaremos o bloco de código abaixo para converter o arquivo XLS de amostra em um arquivo CSV. IronXL preserva a integridade dos dados durante a conversão, incluindo fórmulas e cálculos:

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLS file into a WorkBook object
        // IronXL automatically handles the older XLS format
        WorkBook wb = WorkBook.Load("XLS.xls");

        // Save the WorkBook as a CSV file
        // All formulas are evaluated and results are exported
        wb.SaveAsCsv("Example2.csv");

        // Optional: Export specific worksheet
        // WorkSheet ws = wb.GetWorkSheet("Sheet1");
        // ws.SaveAsCsv("Example2.csv");
    }
}

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLS file into a WorkBook object
        // IronXL automatically handles the older XLS format
        WorkBook wb = WorkBook.Load("XLS.xls");

        // Save the WorkBook as a CSV file
        // All formulas are evaluated and results are exported
        wb.SaveAsCsv("Example2.csv");

        // Optional: Export specific worksheet
        // WorkSheet ws = wb.GetWorkSheet("Sheet1");
        // ws.SaveAsCsv("Example2.csv");
    }
}

Após a execução do código acima, você terá um arquivo CSV recém-gerado. Para cenários mais complexos, talvez você queira selecionar intervalos específicos ou ordenar dados antes de exportar.

Exemplo de arquivo CSV aberto em WordPad mostrado dados devidamente formatados separados por vírgulas com cabeçalhos e várias entradas de produtos

Como Posso Analisar Arquivos CSV de Formato TSV?

Aplicativos de planilhas frequentemente usam arquivos TSV, ou arquivos com valores separados por tabulação, para transferir dados entre bancos de dados. Ele salva uma tabela de dados com tabulações separando as colunas de dados e cada registro em uma linha diferente. Arquivos TSV são particularmente úteis quando seus dados contêm vírgulas que podem interferir com a análise CSV.

IronXL oferece um analisador CSV para analisar arquivos CSV do formato TSV para melhor gerenciamento de dados. O processo de conversão é simples e mantém a integridade dos dados ao longo do processo.

Vamos começar com o exemplo. Primeiro, criaremos um arquivo TSV com dados de alunos:

Exemplo de dados de alunos separados por tabulação exibidos no Microsoft Word, mostrando a estrutura de um arquivo TSV com colunas para NOME, EMAIL, R-NO, e Nota

using IronXL;

class Program
{
    static void Main()
    {
        // Load the TSV file into a WorkBook object
        // IronXL automatically detects tab-separated format
        WorkBook wb = WorkBook.Load("TSV.tsv");

        // Save the WorkBook as a CSV file
        // Tabs are converted to commas automatically
        wb.SaveAsCsv("Example3.csv");

        // Alternative: Load with explicit delimiter specification
        // WorkBook wb = WorkBook.LoadCSV("TSV.tsv", delimiter: "\t");
    }
}

using IronXL;

class Program
{
    static void Main()
    {
        // Load the TSV file into a WorkBook object
        // IronXL automatically detects tab-separated format
        WorkBook wb = WorkBook.Load("TSV.tsv");

        // Save the WorkBook as a CSV file
        // Tabs are converted to commas automatically
        wb.SaveAsCsv("Example3.csv");

        // Alternative: Load with explicit delimiter specification
        // WorkBook wb = WorkBook.LoadCSV("TSV.tsv", delimiter: "\t");
    }
}

Abaixo está a saída em formato CSV. Observe como o IronXL converteu adequadamente os valores separados por tabulação em valores separados por vírgula, mantendo a estrutura dos dados:

Exemplo de arquivo CSV aberto em WordPad exibindo registros de alunos com campos para nome, email, número de matrícula, e nota separados por vírgulas