إنشاء أرشيفات ZIP من ملفات CSV باستخدام C#

اجمع ملف CSV واحدا أو عدة ملفات مع الموارد المرتبطة بها داخل أرشيف ZIP منظم باستخدام .NET.

إنشاء ملف ZIP من ملفات CSV في .NET

تتيح Aspose.ZIP for .NET لتطبيق C# إنشاء أرشيف ZIP من ملفات CSV دون تشغيل 7-Zip أو WinRAR أو أي أداة أرشفة مكتبية أخرى. أنشئ كائنا من Archive، وأضف كل ملف مصدر كمدخل باسم واضح، ثم استدع Save لإنتاج الحزمة النهائية.

CSV هي صيغة بيانات نصية عادية تعتمد على الفواصل أو محددات أخرى بين القيم. تتعامل Aspose.ZIP مع كل ملف مصدر كمدخل ملف مستقل: فهي تحفظ البايتات الأصلية كما هي، وتوفر في الوقت نفسه التغليف داخل ZIP، وإعدادات الضغط، وتنظيم المجلدات، والعمل عبر التدفقات، والتشفير الاختياري. يناسب هذا الأسلوب تسليم مجموعات البيانات، وتصديرات التقارير، وتبادل البيانات على دفعات.

مثال C#: ضغط ملف CSV إلى ZIP

يوضح هذا المثال المختصر باستخدام Aspose.ZIP كيفية إضافة ملف CSV واحد إلى أرشيف جديد وحفظ النتيجة باسم archived_result.zip. عيّن dir إلى المجلد الذي يحتوي على ملف المصدر.

ضغط ملفات CSV - C#var dir = "full directory path";
using (var arch = new Archive())
{
   arch.CreateEntry("filename.csv", dir+"file.csv");
   arch.Save(dir+"archived_result.zip");
}

تثبيت Aspose.ZIP for .NET

ثبّت حزمة Aspose.ZIP من NuGet وأضف مرجعها إلى مشروع .NET. تتم عملية إنشاء ملفات ZIP داخل التطبيق نفسه ولا تحتاج إلى أداة أرشفة مثبتة بشكل منفصل.

Package Manager ConsolePM> Install-Package Aspose.Zip

أرشفة ملف CSV واحد

أضف ملف مصدر ‎.csv واحدا إلى Archive جديد واحفظ النتيجة. استخدم اسم مدخل مقصودا عندما يجب أن يعرض ملف ZIP القابل للتنزيل اسما أقصر أو موحدا.

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

استدع CreateEntry لكل ملف مصدر قبل الحفظ. يمكن ترتيب الملفات القادمة من مسارات إدخال مختلفة داخل مجلد csv/ موحد في أرشيف ZIP.

تضمين الموارد المرتبطة

اجمع ملف CSV مع أوصاف المخطط، وقواميس البيانات، وقيم التحقق، وملفات البيان، أو تعليمات الاستيراد. حافظ على المسارات النسبية وقواعد التسمية التي يتوقعها سير العمل المستلم.

حفظ الحزمة أو تمريرها كتدفق

احفظ ملف ZIP المكتمل في ملف محلي، أو أعده من ASP.NET، أو أرسله مباشرة إلى تخزين كائنات عبر تدفق قابل للكتابة. يبقى تنظيم المداخل نفسه أيا كانت وجهة الإخراج.

كيفية إنشاء أرشيف ZIP من ملفات CSV باستخدام C#

ثبّت Aspose.ZIP for .NET وأضف مرجعه إلى المشروع.
حدّد ملفات CSV والموارد المرتبطة المطلوبة داخل الحزمة.
أنشئ كائنا من Archive لحاوية ZIP الجديدة.
استدع CreateEntry لكل ملف مصدر وعيّن له المسار المقصود داخل الأرشيف.
اضبط الضغط أو التشفير عندما تتطلب طريقة التسليم ذلك.
استدع Save مع مسار إخراج أو تدفق قابل للكتابة، ثم تخلص من كائن الأرشيف.

أضف كل المداخل المطلوبة قبل الحفظ. استخدم استدعاءات CreateEntry المنفردة للحزم المنتقاة بعناية، أو استخدم CreateEntries عندما تريد إضافة شجرة مجلدات جاهزة بشكل تكراري.

تغليف ZIP لا يحول صيغة CSV

يحفظ تغليف ZIP البايتات كما هي، ولا يتحقق من الصفوف، ولا يستنتج مخطط البيانات، ولا يغير المحددات، ولا يطبّع الترميزات، ولا يحول CSV إلى Excel أو قاعدة بيانات. عند استخراج المدخل يعود الملف بنفس البايتات التي أضيفت، ما لم يحوله التطبيق صراحة قبل الأرشفة.

استخدم مكتبة مناسبة لمعالجة الصيغة عندما يكون المطلوب فحص المحتوى الداخلي أو تحريره أو عرضه أو التحقق منه أو تحويله. واستخدم Aspose.ZIP عندما يكون المطلوب هو تجميع الملف الحالي أو نقله أو تخزينه أو ضغطه أو حمايته.

تضمين الملفات المرافقة مع مصدر CSV

قد تحتاج عمليات التسليم الواقعية إلى أوصاف مخطط، أو قواميس بيانات، أو قيم تحقق، أو ملفات بيان، أو تعليمات استيراد. تضيف Aspose.ZIP فقط الملفات التي يمررها التطبيق، ولا تكتشف الاعتماديات الخاصة بالصيغة تلقائيا.

اجمع الموارد المطلوبة قبل إنشاء الأرشيف، وامنحها مسارات إدخال نسبية مستقرة. يمكن لملف بيان أو README أن يوثق الإصدارات، والمواقع المتوقعة، وقيم التحقق، وتعليمات الاستعادة للمستلم.

التحكم في المسارات والأسماء داخل ZIP الخاص بملفات CSV

يخبر مسار المصدر .NET من أين يقرأ الملف، بينما يحدد اسم المدخل مكان ظهوره داخل ZIP. لذلك يمكن عرض ملف محلي باسم مثل `csv/filename.csv` دون كشف مساره الحقيقي على الجهاز.

استخدم الشرطات المائلة للأمام في مسارات المداخل لضمان قابلية النقل. ارفض المسارات المطلقة، ومقاطع الرجوع إلى المجلد الأب مثل ../، والأسماء الفارغة، والتكرارات غير المتوقعة عندما تأتي الأسماء من خارج التطبيق.

ما مقدار الضغط المتوقع من ملفات CSV

غالبا ما تنضغط ملفات CSV بشكل ممتاز بسبب تكرار المحددات والقيم وأنماط الأعمدة عبر الصفوف. تعتمد النسبة على تنوع القيم، وطريقة الاقتباس، وعدد السجلات. يعد Deflate الخيار العملي الافتراضي للتوافق الواسع مع أدوات ZIP، بينما قد يكون وضع Store مفيدا عندما تكون سرعة التغليف أهم من تقليل الحجم.

قارن ملفات ممثلة بدلا من الوعد بنسبة ضغط ثابتة. حجم الملف، والترميز الداخلي، والبيانات المتكررة، والموارد المضمنة كلها تؤثر في حجم ZIP النهائي.

حماية أرشيف ZIP لملفات CSV بكلمة مرور

يمكن لـ Aspose.ZIP حماية مداخل الأرشيف باستخدام ZipCrypto التقليدي أو تشفير AES. فضّل AES عندما يدعمه البرنامج الذي سيستخدمه المستلمون، واستخدم ZipCrypto فقط عند الحاجة إلى التوافق مع أدوات أقدم.

احصل على كلمات المرور من إعدادات آمنة، ولا تضعها أبدا مباشرة في الشيفرة أو السجلات، وأرسل بيانات الاعتماد منفصلة عن الأرشيف. يحمي التشفير ملف ZIP أثناء النقل أو التخزين، لكنه لا يغني عن ضوابط الوصول الخاصة بالمحتوى.

إرشادات الإنتاج لسير عمل أرشفة CSV

- تحقق من وجود كل ملف مصدر وكل ملف مرافق مطلوب قبل الحفظ. - حدّد عدد الملفات وحجم كل ملف والحجم الكلي ومواقع المصادر المسموح بها عند التعامل مع طلبات غير موثوقة. - طبّع أسماء المداخل وامنع المسارات المطلقة أو التنقل خارج المجلد المقصود. - اكتب إلى وجهة مؤقتة، ولا انشر النتيجة إلا بعد نجاح `Save` عندما يكون الإخراج الجزئي ضارا. - استخدم التدفقات لاستجابات ASP.NET وعمليات الرفع المباشر إلى تخزين الكائنات. - تخلص من الأرشيفات والتدفقات بطريقة حتمية، وتجنب كشف المسارات المحلية أو بيانات الاعتماد في السجلات.