نظرة عامة

في عالم إدارة البيانات، يعتبر التعامل مع ملفات القيم المفصولة بفواصل (CSV) متطلبًا شائعًا. تُستخدم هذه الملفات على نطاق واسع لتخزين البيانات الجدولية مثل أوراق العمل أو قواعد البيانات نظرًا لبساطتها وسهولة قراءتها. يمكن أن يوفر القدرة على دمج وتقسيم ملفات CSV برمجيًا الوقت ويسهل سير العمل، خاصة عند التعامل مع كميات كبيرة من البيانات.

تقدم هذه المقالة دليلًا خطوة بخطوة حول كيفية دمج وتقسيم ملفات CSV باستخدام مكتبة GroupDocs.Merger for .NET.

كيفية دمج ملفات CSV

يمكن أن يسهل دمج عدة ملفات CSV في مستند واحد التعامل مع البيانات والتقارير بشكل كبير. في C#، تجعل مكتبة GroupDocs.Merger for .NET هذه العملية بسيطة وفعالة، مما يلغي الحاجة إلى التلاعب اليدوي بالبيانات. إليك الخطوات الرئيسية لدمج ملفات CSV باستخدام C#:

  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");
            
            // تحميل ملف CSV المصدر باستخدام فئة Merger
            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}");
        }
    }
}

في هذا المقتطف:

  • يتمInstantiation فئة Merger بمسار ملف CSV الأول.
  • يتم استدعاء طريقة 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

يوضح هذا المثال كيفية دمج عدة ملفات CSV في ملف واحد باستخدام حزمة GroupDocs.Merger. تأكد من ضبط المسارات لملفات العينات الخاصة بك بشكل صحيح.

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($"تم تقسيم المستند المصدر إلى ملفات أسطر فردية بنجاح.");
        }
    }
}

انظر أيضا

للحصول على مزيد من المعلومات والموارد التقنية، تحقق من الروابط أدناه:

معلومات التجربة المجانية والترخيص المؤقت

يمكنك تنزيل نسخة تجريبية مجانية من GroupDocs.Merger من releases.groupdocs.com. بالنسبة لأولئك الذين يفكرون في تقييم أكثر شمولاً، يمكنك أيضًا الحصول على ترخيص مؤقت من هنا. يتيح لك هذا الترخيص المؤقت اختبار مكتبتنا بدون أي قيود، مما يضمن لك إمكانية استكشاف قدراتها بالكامل.