Visão Geral

No mundo da gestão de dados, o manuseio de arquivos Comma Separated Values (CSV) é um requisito comum. Esses arquivos são amplamente utilizados para armazenar dados tabulares, como planilhas ou bases de dados, devido à sua simplicidade e fácil legibilidade. A capacidade de unir e dividir arquivos CSV programaticamente pode economizar tempo e otimizar fluxos de trabalho, especialmente ao lidar com grandes volumes de dados.

Este artigo fornece um guia passo a passo sobre como unir e dividir arquivos CSV usando a biblioteca GroupDocs.Merger para .NET.

Como Unir Arquivos CSV

Juntar vários arquivos CSV em um único documento pode simplificar significativamente o manuseio e a análise de dados. Em C#, a biblioteca GroupDocs.Merger para .NET torna esse processo direto e eficiente, eliminando a necessidade de manipulação manual de dados. Abaixo estão os passos principais para unir arquivos CSV usando C#:

  1. Carregue seu arquivo CSV fonte: Crie uma instância da classe Merger, passando o caminho do arquivo do primeiro arquivo CSV como parâmetro.
  2. Adicione arquivos CSV adicionais: Use o método Join para adicionar outros arquivos CSV que você deseja unir ao primeiro documento.
  3. Salve o resultado combinado: Chame o método Save para escrever os dados combinados em um novo arquivo CSV.

Aqui está um exemplo ilustrando esses passos:

// Importar namespaces necessários
using System;
using System.IO;

namespace GroupDocs.Merger.Examples.CSharp.BasicUsage
{
    /// <summary>
    /// Este exemplo demonstra como unir múltiplos arquivos CSV em um único arquivo.
    /// </summary>
    internal static class MergeCsv
    {
        public static void Run()
        {
            Console.WriteLine("=======================================================================");
            Console.WriteLine("Exemplo de Uso Básico: MergeCsv");
            Console.WriteLine();

            // Definir a pasta de saída e o nome do arquivo
            string outputFolder = Constants.GetOutputDirectoryPath();
            string outputFile = Path.Combine(outputFolder, "merged.csv");
            
            // Carregar o arquivo CSV fonte usando a classe Merger
            using (var merger = new GroupDocs.Merger.Merger(Constants.SAMPLE_CSV))
            {
                // Adicionar outro arquivo CSV para unir
                merger.Join(Constants.SAMPLE_CSV_2);
                
                // Unir arquivos CSV e salvar o resultado em 'merged.csv'
                merger.Save(outputFile);
            }

            Console.WriteLine("A união dos arquivos CSV foi concluída com sucesso.");
            Console.WriteLine($"Verifique a saída em {outputFolder}");
        }
    }
}

Neste trecho de código:

  • A classe Merger é instanciada com o caminho do primeiro arquivo CSV.
  • O método Join é chamado para incluir outro arquivo CSV.
  • O arquivo final unido é salvo com o método Save.

Como Dividir Arquivos CSV

Dividir um grande arquivo CSV em partes menores e manejáveis é igualmente essencial para a governança e análise de dados. Isso é especialmente útil quando você precisa isolar pontos de dados ou gerenciar tamanhos de arquivos para processamento. Com a biblioteca GroupDocs.Merger para .NET, dividir arquivos CSV é tão fácil quanto unir. Abaixo estão os passos para dividir um arquivo CSV em documentos separados:

  1. Defina o formato de saída: Especifique a convenção de nomenclatura para os arquivos de saída (por exemplo, line_1.csv, line_2.csv, etc.).
  2. Use o método Split: Aplique este método da classe Merger, juntamente com as opções apropriadas que ditam como a divisão deve ocorrer.
  3. Gerencie a saída: Após a divisão, você terá cada linha ou segmento especificado como seu próprio arquivo separado.

Aqui está como você pode realizar isso com C#:

// Importar namespaces necessários
using System;
using System.IO;
using GroupDocs.Merger.Domain.Options;

namespace GroupDocs.Merger.Examples.CSharp.BasicUsage
{
    /// <summary>
    /// Este exemplo demonstra como dividir um arquivo CSV em documentos separados.
    /// </summary>
    public class SplitCsv
    {
        public static void Run()
        {
            Console.WriteLine("=======================================================================");
            Console.WriteLine("Exemplo de Uso Básico: SplitCsv");
            Console.WriteLine();

            // Definir o caminho para o arquivo CSV
            string filePath = Constants.SAMPLE_CSV;
            // Definir o caminho de saída com um padrão de nomenclatura
            string filePathOut = Path.Combine(Constants.GetOutputDirectoryPath(), "line_{0}.csv");

            // Criar opções de divisão para definir como dividir
            TextSplitOptions splitOptions = new TextSplitOptions(filePathOut, new int[] { 1, 2, 3 });

            using (Merger merger = new Merger(filePath))
            {
                // Dividir o arquivo CSV de acordo com as opções especificadas
                merger.Split(splitOptions);
            }

            Console.WriteLine("O documento fonte foi dividido com sucesso.");
            Console.WriteLine($"Verifique a saída em {filePathOut}.");
        }
    }
}

Neste exemplo:

  • O script segmenta os dados com base em números de linha especificados e salva cada segmento como um novo arquivo CSV.
  • A classe TextSplitOptions permite uma configuração flexível de como a divisão ocorre.

Veja também

Para mais informações e recursos, confira os seguintes links:

Você pode baixar uma versão de avaliação gratuita em releases.groupdocs.com e obter uma licença temporária aqui para experimentar nossa biblioteca sem restrições.

Exemplos de Código

Para lhe dar uma melhor compreensão de como usar efetivamente a biblioteca GroupDocs.Merger para .NET, aqui estão alguns exemplos práticos que demonstram a união e a divisão de arquivos CSV. Esses trechos podem ser facilmente adaptados para se adequar às suas necessidades específicas de processamento de dados.

Exemplo: Unindo Múltiplos Arquivos CSV

Este exemplo demonstra a união de múltiplos arquivos CSV em um único arquivo usando o pacote GroupDocs.Merger. Certifique-se de que os caminhos para seus arquivos de exemplo estejam corretamente definidos.

using System;
using System.IO;

namespace GroupDocs.Merger.Examples.CSharp.BasicUsage
{
    internal static class MergeMultipleCsvFiles
    {
        public static void Run()
        {
            Console.WriteLine("Unindo múltiplos arquivos CSV.");

            // Definir a pasta de saída e o nome do arquivo de saída para o CSV unido
            string outputFolder = Constants.GetOutputDirectoryPath();
            string outputFile = Path.Combine(outputFolder, "merged_result.csv");
            
            // Iniciar o processo de união
            using (var merger = new GroupDocs.Merger.Merger(Constants.SAMPLE_CSV))
            {
                merger.Join(Constants.SAMPLE_CSV_2); // Adicionar segundo arquivo CSV
                merger.Join(Constants.SAMPLE_CSV_3); // Adicionar terceiro arquivo CSV
                merger.Save(outputFile); // Salvar resultado combinado
            }

            Console.WriteLine($"Arquivos CSV unidos com sucesso em {outputFile}");
        }
    }
}

Exemplo: Dividindo um Arquivo CSV em Linhas Individuais

Neste trecho, vamos dividir um grande arquivo CSV em múltiplos arquivos menores, cada um contendo linhas especificadas. Isso pode ser útil para processar grandes conjuntos de dados ou distribuir carga de trabalho.

using System;
using System.IO;
using GroupDocs.Merger.Domain.Options;

namespace GroupDocs.Merger.Examples.CSharp.BasicUsage
{
    public class SplitCsvToLines
    {
        public static void Run()
        {
            Console.WriteLine("Dividindo um arquivo CSV em arquivos de linha individuais.");

            // Especificar o caminho do arquivo CSV fonte
            string filePath = Constants.SAMPLE_CSV;
            // Definir padrão de nomenclatura para o arquivo de saída do resultado dividido
            string outputFilePath = Path.Combine(Constants.GetOutputDirectoryPath(), "line_{0}.csv");

            // Configurar opções de divisão com base nos números de linha desejados
            TextSplitOptions splitOptions = new TextSplitOptions(outputFilePath, new int[] { 1, 2, 3 });

            using (Merger merger = new Merger(filePath))
            {
                merger.Split(splitOptions); // Dividir o arquivo com base nas opções
            }

            Console.WriteLine($"Arquivo fonte dividido com sucesso em arquivos de linha individuais.");
        }
    }
}

Veja também

Para mais informações e recursos técnicos, confira os links abaixo:

Informações sobre Avaliação Gratuita e Licença Temporária

Você pode baixar uma versão de avaliação gratuita do GroupDocs.Merger em releases.groupdocs.com. Para aqueles que consideram uma avaliação mais extensa, você também pode adquirir uma licença temporária aqui. Esta licença temporária permite que você teste nossa biblioteca sem quaisquer limitações, garantindo que você possa explorar totalmente suas capacidades.