概述

在数据管理的世界中，处理逗号分隔值（CSV）文件是一项常见的需求。这些文件广泛用于存储表格数据，如电子表格或数据库，因为它们简单且易于阅读。以编程方式合并和拆分 CSV 文件可以节省时间并简化工作流程，特别是在处理大量数据时。

本文提供了如何使用 GroupDocs.Merger for .NET 库合并和拆分 CSV 文件的逐步指南。

如何合并 CSV 文件

将多个 CSV 文件合并为一个文档可以显著简化数据处理和报告。在 C# 中，GroupDocs.Merger for .NET 库使这个过程简单而高效，消除了手动数据操作的需要。以下是在 C# 中合并 CSV 文件的关键步骤：

  1. 加载源 CSV 文件： 创建 Merger 类的实例，传入第一个 CSV 文件的文件路径作为参数。
  2. 添加其他 CSV 文件： 使用 Join 方法将其他要合并的 CSV 文件添加到第一个文档中。
  3. 保存合并结果： 调用 Save 方法将合并的数据写入一个新的 CSV 文件。

以下是说明这些步骤的示例：

// 导入必要的命名空间
using System;
using System.IO;

namespace GroupDocs.Merger.Examples.CSharp.BasicUsage
{
    /// <summary>
    /// 此示例演示如何将多个 CSV 文件合并为一个文件。
    /// </summary>
    internal static class MergeCsv
    {
        public static void Run()
        {
            Console.WriteLine("=======================================================================");
            Console.WriteLine("示例基本用法：MergeCsv");
            Console.WriteLine();

            // 定义输出文件夹和文件名
            string outputFolder = Constants.GetOutputDirectoryPath();
            string outputFile = Path.Combine(outputFolder, "merged.csv");
            
            // 使用 Merger 类加载源 CSV 文件
            using (var merger = new GroupDocs.Merger.Merger(Constants.SAMPLE_CSV))
            {
                // 添加另一个 CSV 文件以进行合并
                merger.Join(Constants.SAMPLE_CSV_2);
                
                // 合并 CSV 文件并将结果保存到 'merged.csv'
                merger.Save(outputFile);
            }

            Console.WriteLine("CSV 文件合并成功完成。");
            Console.WriteLine($"请查看输出位于 {outputFolder}");
        }
    }
}

在此代码片段中：

  • 使用第一个 CSV 文件的路径实例化 Merger 类。
  • 调用 Join 方法以包含另一个 CSV 文件。
  • 最终合并文件使用 Save 方法保存。

如何拆分 CSV 文件

将大型 CSV 文件拆分为较小、可管理的部分，对于数据治理和分析同样重要。当您需要孤立数据点或管理处理文件大小时，这尤为有用。使用 GroupDocs.Merger for .NET 库，拆分 CSV 文件与合并一样简单。以下是将 CSV 文件拆分为单独文档的步骤：

  1. 定义输出格式： 指定输出文件的命名约定（例如，line_1.csv、line_2.csv 等）。
  2. 使用 Split 方法： 在 Merger 类中应用此方法，并提供规定拆分方式的相应选项。
  3. 管理输出： 拆分后，您将拥有每行或指定段落作为独立文件。

以下是如何使用 C# 实现此功能：

// 导入必要的命名空间
using System;
using System.IO;
using GroupDocs.Merger.Domain.Options;

namespace GroupDocs.Merger.Examples.CSharp.BasicUsage
{
    /// <summary>
    /// 此示例演示如何将 CSV 文件拆分为单独的文档。
    /// </summary>
    public class SplitCsv
    {
        public static void Run()
        {
            Console.WriteLine("=======================================================================");
            Console.WriteLine("示例基本用法：SplitCsv");
            Console.WriteLine();

            // 定义 CSV 文件的路径
            string filePath = Constants.SAMPLE_CSV;
            // 定义输出路径和命名模式
            string filePathOut = Path.Combine(Constants.GetOutputDirectoryPath(), "line_{0}.csv");

            // 创建拆分选项以定义拆分方式
            TextSplitOptions splitOptions = new TextSplitOptions(filePathOut, new int[] { 1, 2, 3 });

            using (Merger merger = new Merger(filePath))
            {
                // 根据指定的选项拆分 CSV 文件
                merger.Split(splitOptions);
            }

            Console.WriteLine("源文档拆分成功。");
            Console.WriteLine($"请查看输出位于 {filePathOut}。");
        }
    }
}

在此示例中：

  • 脚本根据指定行号分段数据，并将每个段落保存为新的 CSV 文件。
  • TextSplitOptions 类允许灵活配置拆分发生的方式。

另请参见

有关更多信息和资源，请查看以下链接：

您可以从 releases.groupdocs.com 下载免费试用版，并在 这里 获取临时许可证，以无条件尝试我们的库。

代码示例

为了让您更好地理解如何有效地使用 GroupDocs.Merger for .NET 库，这里有一些实际示例展示了合并和拆分 CSV 文件。这些代码片段可以轻松调整以适应您特定的数据处理需求。

示例：合并多个 CSV 文件

此示例演示如何使用 GroupDocs.Merger 包将多个 CSV 文件合并为一个文件。确保您的示例文件的路径设置正确。

using System;
using System.IO;

namespace GroupDocs.Merger.Examples.CSharp.BasicUsage
{
    internal static class MergeMultipleCsvFiles
    {
        public static void Run()
        {
            Console.WriteLine("合并多个 CSV 文件。");

            // 定义输出文件夹和合并 CSV 的输出文件名
            string outputFolder = Constants.GetOutputDirectoryPath();
            string outputFile = Path.Combine(outputFolder, "merged_result.csv");
            
            // 开始合并过程
            using (var merger = new GroupDocs.Merger.Merger(Constants.SAMPLE_CSV))
            {
                merger.Join(Constants.SAMPLE_CSV_2); // 添加第二个 CSV 文件
                merger.Join(Constants.SAMPLE_CSV_3); // 添加第三个 CSV 文件
                merger.Save(outputFile); // 保存合并结果
            }

            Console.WriteLine($"成功将 CSV 文件合并到 {outputFile}");
        }
    }
}

示例：将 CSV 文件拆分为单独的行

在此代码片段中，我们将大型 CSV 文件拆分为多个较小的文件，每个文件包含指定的行。这对处理大型数据集或分配工作负载特别有用。

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("将 CSV 文件拆分为单独的行文件。");

            // 指定源 CSV 文件的路径
            string filePath = Constants.SAMPLE_CSV;
            // 定义拆分结果的输出文件命名模式
            string outputFilePath = Path.Combine(Constants.GetOutputDirectoryPath(), "line_{0}.csv");

            // 根据所需的行号设置拆分选项
            TextSplitOptions splitOptions = new TextSplitOptions(outputFilePath, new int[] { 1, 2, 3 });

            using (Merger merger = new Merger(filePath))
            {
                merger.Split(splitOptions); // 根据选项拆分文件
            }

            Console.WriteLine($"成功将源文档拆分为单独的行文件。");
        }
    }
}

另请参见

有关更多信息和技术资源，请查看以下链接：

免费试用和临时许可证信息

您可以从 releases.groupdocs.com 下载 GroupDocs.Merger 的免费试用版。对于考虑更广泛评估的用户，您还可以从 这里 获取临时许可证。此临时许可证允许您无限制地测试我们的库，确保您可以充分探索其功能。