تقديم أرشيفات ZIP باستخدام C #

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

تتم مناقشة / تغطية الموضوعات التالية في هذه المقالة:

• C # API لعرض ملفات ZIP
• تقديم أرشيفات مضغوطة بتنسيق HTML
• عرض مجلد محدد من أرشيفات مضغوطة بتنسيق HTML
• عرض محتوى أرشيفات مضغوطة بتنسيق PDF
• تقديم أرشيفات بتنسيق ZIP إلى JPG
• احصل على قائمة المجلدات من أرشيفات ZIP
• عرض وإعادة تسمية ملفات ZIP

C # API لعرض ملفات ZIP

لعرض ملفات ZIP ، سأستخدم GroupDocs.Viewer for .NET API. إنها واجهة برمجة تطبيقات قوية لعارض المستندات تدعم أكثر من 170 نوعًا من الملفات والمستندات. توفر واجهة برمجة التطبيقات (API) أكثر حلول عرض المستندات مرونة لتقديم وعرض تنسيقات الملفات المستخدمة على نطاق واسع في أي مكان دون تثبيت أي برنامج خارجي. كما أنه يمكّنك من عرض ملفات PDF و HTML و XML و Microsoft Office Word وأوراق عمل Excel وعروض PowerPoint التقديمية ورسائل البريد الإلكتروني في Outlook ومخططات Visio والمشروع وملفات التعريف والصور والعديد من تنسيقات الملفات الأخرى بسرعة وبسهولة وبأقل مخاطر البرمجة.

يمكنك إما تنزيل DLL من API أو تثبيته باستخدام NuGet.

Install-Package GroupDocs.Viewer

تقديم أرشيفات مضغوطة بتنسيق HTML

يمكنك عرض ملف ZIP بتنسيق HTML باتباع الخطوات البسيطة الموضحة أدناه:

1. قم بإنشاء مثيل للفئة Viewer
2. قم بتوفير مسار ملف الإدخال
3. قم بإنشاء مثيل لفئة HtmlViewOptions
4. توفير مسار ملف الإخراج
5. قم باستدعاء طريقة View () وقم بتمرير HtmlViewOptions

يوضح نموذج التعليمات البرمجية التالي كيفية عرض ملف ZIP بتنسيق HTML باستخدام C #.

// تهيئة العارض
Viewer viewer = new Viewer("C:\\Files\\sample.zip");

// تحديد خيارات عرض HTML
HtmlViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources("C:\\Files\\output.html");
viewOptions.RenderToSinglePage = true;

// خلق وجهة نظر
viewer.View(viewOptions);

فئة Viewer هي الفئة الرئيسية التي توفر وظائف للتحكم في عملية عرض المستند. طريقة View () لهذه الفئة تنشئ طريقة عرض كل صفحات الوثيقة.

توفر فئة HtmlViewOptions خيارات لتحويل المستندات إلى تنسيق HTML. تنشئ طريقة المُنشئ ForEmbeddedResources مثيلًا جديدًا لفئة HtmlViewOptions لعرضها في HTML باستخدام الموارد المضمنة. كما ترى ، لقد قدمت مسار ملف الإخراج في مثال الكود.

يمكنك العثور على مزيد من التفاصيل حول “Document HTML Viewer” في الوثائق.

عرض مجلد محدد من أرشيفات مضغوطة بتنسيق HTML

يمكنك عرض مجلد محدد متاحًا داخل ملف ZIP بتنسيق HTML باتباع الخطوات البسيطة الموضحة أدناه:

1. قم بإنشاء مثيل للفئة Viewer
2. قم بتوفير مسار ملف الإدخال
3. قم بإنشاء مثيل لفئة HtmlViewOptions
4. توفير مسار ملف الإخراج
5. اضبط اسم المجلد المطلوب عرضه
6. قم باستدعاء طريقة View () وقم بتمرير HtmlViewOptions

يوضح نموذج التعليمات البرمجية التالي كيفية عرض مجلد معين من ملف ZIP بتنسيق HTML باستخدام C #.

// تهيئة العارض
Viewer viewer = new Viewer("C:\\Files\\sample.zip");

// تحديد خيارات عرض HTML
HtmlViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources("C:\\Files\\output.html");
// تعيين اسم المجلد
viewOptions.ArchiveOptions.Folder = "ThirdFolderWithItems";

// خلق وجهة نظر
viewer.View(viewOptions);

توفر فئة ArchiveOptions خيارات لعرض ملفات الأرشيف. يمكّنك من عرض مجلد معين من أرشيفات مضغوطة من خلال توفير اسم المجلد المتاح داخل الأرشيف.

عرض محتوى أرشيفات مضغوطة بتنسيق PDF

يمكنك عرض ملف ZIP في مستند PDF باتباع الخطوات البسيطة الموضحة أدناه:

1. قم بإنشاء مثيل للفئة Viewer
2. قم بتوفير مسار ملف الإدخال
3. قم بإنشاء مثيل لفئة PdfViewOptions
4. توفير مسار ملف الإخراج
5. قم باستدعاء طريقة View () وتمرير PdfViewOptions

يوضح نموذج التعليمات البرمجية التالي كيفية عرض ملف ZIP في PDF باستخدام C #.

// تهيئة العارض
Viewer viewer = new Viewer("C:\\Files\\sample.zip");

// تحديد خيارات عرض PDF
PdfViewOptions options = new PdfViewOptions("C:\\Files\\output.pdf");

// خلق وجهة نظر
viewer.View(viewOptions);

توفر فئة PdfViewOptions خيارات لتحويل المستندات إلى تنسيق PDF. يمكنك العثور على مزيد من التفاصيل حول “Document PDF Viewer” في الوثائق.

تقديم أرشيفات بتنسيق ZIP إلى JPG

يمكنك عرض ملف ZIP في صورة JPG باتباع الخطوات البسيطة الموضحة أدناه:

1. قم بإنشاء مثيل للفئة Viewer
2. قم بتوفير مسار ملف الإدخال
3. قم بإنشاء مثيل لفئة JpgViewOptions
4. توفير مسار ملف الإخراج
5. قم باستدعاء طريقة View () وتمرير JpgViewOptions

يوضح نموذج التعليمات البرمجية التالي كيفية عرض ملف ZIP في صورة JPG باستخدام C #.

// تهيئة العارض
Viewer viewer = new Viewer("C:\\Files\\sample.zip");

// تحديد خيارات عرض JPG
JpgViewOptions options = new JpgViewOptions("C:\\Files\\output_page_{0}.jpg");

// خلق وجهة نظر
viewer.View(viewOptions);

يمكنك عرض المستندات بتنسيقات صور JPG أو PNG. توفر فئة JpgViewOptions خيارات لتحويل المستندات إلى تنسيق JPG. وبالمثل ، توفر فئة PngViewOptions خيارات لعرض المستندات بتنسيق PNG.

يمكنك العثور على مزيد من التفاصيل حول “عارض صورة المستند” في الوثائق.

احصل على قائمة المجلدات من أرشيفات ZIP

يمكنك الحصول على قائمة بجميع المجلدات والمجلدات الفرعية من ملف ZIP برمجيًا باتباع الخطوات الواردة أدناه:

1. قم بإنشاء مثيل للفئة Viewer
2. قم بتوفير مسار ملف الإدخال
3. إنشاء ViewInfoOptions
4. قم بإنشاء مثيل ViewInfo عن طريق استدعاء طريقة GetViewInfo ()
5. احصل على ArchiveViewInfo
6. اعرض النتائج

يوضح نموذج التعليمات البرمجية التالي كيفية الحصول على قائمة المجلدات من ملف ZIP باستخدام C #.

// تهيئة العارض
Viewer viewer = new Viewer("C:\\Files\\sample.zip");

// إنشاء خيارات عرض المعلومات
ViewInfoOptions viewInfoOptions = ViewInfoOptions.ForHtmlView();
ViewInfo viewInfo = viewer.GetViewInfo(viewInfoOptions);

Console.WriteLine("File type: " + viewInfo.FileType);
Console.WriteLine("Pages count: " + viewInfo.Pages.Count);
Console.WriteLine("Folders: ");
Console.WriteLine(" - /");

string rootFolder = string.Empty;
viewInfoOptions.ArchiveOptions.Folder = rootFolder;

// الحصول على معلومات العرض
ArchiveViewInfo viewFolderInfo = viewer.GetViewInfo(viewInfoOptions) as ArchiveViewInfo;

foreach (string subFolder in viewFolderInfo.Folders)
{
    Console.WriteLine($" - {subFolder}");
    PrintFolders(viewer, subFolder);
}

توفر فئة ViewInfoOptions الخيارات المستخدمة لاسترداد المعلومات حول طريقة العرض. يوفر طرقًا مختلفة للحصول على معلومات عرض لتنسيقات معينة. لقد استخدمت طريقة ForHtmlView () التي تهيئ مثيلًا جديدًا لفئة ViewInfoOptions لاسترداد معلومات حول العرض عند التقديم إلى HTML.

توفر فئة ViewInfo معلومات عرض للمستندات العامة. تقوم طريقة GetViewInfo () الخاصة بفئة Viewer بإرجاع معلومات حول طريقة العرض والمعلومات الخاصة بالمستند.

توفر فئة ArchiveViewInfo معلومات العرض لملف الأرشيف.

عرض وإعادة تسمية ملفات ZIP

يمكنك إعادة تسمية ملفات ZIP أثناء العرض برمجيًا باتباع الخطوات الواردة أدناه:

1. قم بإنشاء مثيل للفئة Viewer
2. قم بتوفير مسار ملف الإدخال
3. قم بإنشاء مثيل لفئة PdfViewOptions
4. توفير مسار ملف الإخراج
5. قم بتعيين اسم ملف جديد لعرضه
6. قم باستدعاء طريقة View () وتمرير PdfViewOptions

يوضح نموذج التعليمات البرمجية التالي كيفية إعادة تسمية ملف ZIP أثناء التقديم باستخدام C #.

// تهيئة العارض
Viewer viewer = new Viewer("C:\\Files\\sample.zip");

// تحديد خيارات عرض PDF
PdfViewOptions viewOptions = new PdfViewOptions("C:\\Files\\output.pdf");
// تعيين اسم ملف جديد
viewOptions.ArchiveOptions.FileName = new FileName("MyFiles");

viewer.View(viewOptions);

توفر فئة ArchiveOptions خاصية FileName التي تُستخدم لعرض اسم الملف في الرأس. يمكنك تعيين اسم عرض جديد كما هو موضح في مثال الرمز أعلاه. بشكل افتراضي ، يعرض اسم الملف المصدر.

احصل على رخصة مجانية

يمكنك تجربة واجهة برمجة التطبيقات بدون قيود التقييم من خلال طلب ترخيص مؤقت مجاني.

استنتاج

في هذه المقالة ، تعلمت كيفية عرض أرشيفات ZIP باستخدام C #. لقد تعلمت أيضًا كيفية تحويل وعرض محتوى ملفات ZIP في صور HTML و PDF و JPG. علاوة على ذلك ، تعلمت كيفية الحصول على قائمة بالمجلدات والمجلدات الفرعية من أرشيف ZIP برمجيًا في C #. يمكنك معرفة المزيد حول GroupDocs.Viewer لـ .NET API باستخدام التوثيق. في حالة وجود أي غموض ، فلا تتردد في الاتصال بنا على المنتدى.

أنظر أيضا

• عرض ملفات CAD في C # باستخدام .NET API
• تشغيل وإيقاف صور GIF و APNG المتحركة باستخدام C #