آرشیوهای ZIP را با استفاده از C# رندر کنید

فایل‌های ZIP حاوی یک یا چند فایل یا پوشه فشرده هستند که به عنوان یک فایل واحد عمل می‌کنند. این فایل‌ها به طور گسترده‌ای برای صرفه‌جویی در فضای ذخیره‌سازی و افزایش عملکرد رایانه‌های شما استفاده می‌شوند. شما می‌توانید به طور مؤثر فایل‌ها و پوشه‌های خود را در یک آرشیو ZIP از یک مکان به مکان دیگر منتقل کنید. به عنوان یک توسعه‌دهنده C#، می‌توانید به راحتی آرشیوهای ZIP را ایجاد کرده و محتوای آن‌ها را به صورت برنامه‌نویسی مشاهده کنید. این مقاله بر روی چگونگی ایجاد آرشیوهای ZIP با استفاده از C# متمرکز خواهد شد.

موضوعات زیر در این مقاله بحث شده‌اند/ پوشش داده شده‌اند:

• C# API برای مشاهده فایل‌های ZIP
• فایل‌های ZIP را در HTML نمایش دهید
• رندر پوشه خاص از آرشیوهای ZIP در HTML
• مشاهده محتوای آرشیوهای ZIP در PDF
• فایل‌های ZIP را به JPG تبدیل کنید
• فهرستی از پوشه‌ها را از آرشیوهای ZIP بگیرید
• فایل‌های ZIP را رندر و نام‌گذاری کنید

C# API برای مشاهده فایل‌های ZIP

برای رندر کردن فایل‌های ZIP، من از GroupDocs.Viewer for .NET API استفاده خواهم کرد. این یک API قدرتمند برای نمایش اسناد است که از بیش از 170 نوع فایل و سند پشتیبانی می‌کند. این API انعطاف‌پذیرترین راه‌حل مشاهده سند را برای رندر و نمایش فرمت‌های فایل پرکاربرد در هر مکان بدون نیاز به نصب نرم‌افزار خارجی ارائه می‌دهد. همچنین به شما این امکان را می‌دهد که به سرعت فایل‌های PDF، HTML، XML، Microsoft Office Word، کاربرگ‌های Excel، ارائه‌های PowerPoint، ایمیل‌های Outlook، دیاگرام‌های Visio، پروژه، متا فایل‌ها، تصاویر و انواع دیگر فرمت‌های فایل را با سهولت و با خطرات برنامه‌نویسی کمتر مشاهده کنید.

شما می‌توانید یا download DLL API را دانلود کنید یا از NuGet برای نصب آن استفاده کنید.

Install-Package GroupDocs.Viewer

فایل‌های فشرده ZIP را در HTML نمایش دهید

شما می‌توانید فایل ZIP را با پیروی از مراحل ساده‌ای که در زیر ارائه شده است، در HTML نشان دهید:

1. یک نمونه از کلاس Viewer را ایجاد کنید
2. Provide the input file path
3. یک نمونه از HtmlViewOptions کلاس ایجاد کنید
4. Provide output file path
5. Call the View() method and pass HtmlViewOptions

کد نمونه زیر نشان می‌دهد که چگونه فایل ZIP را در HTML با استفاده از C# رندر کنیم.

// initialize viewer
Viewer viewer = new Viewer("C:\\Files\\sample.zip");

// define HTML view options
HtmlViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources("C:\\Files\\output.html");
viewOptions.RenderToSinglePage = true;

// create view
viewer.View(viewOptions);

کلاس Viewer کلاس اصلی است که عملکردی برای کنترل فرآیند رندر کردن سند ارائه می‌دهد. متد View() این کلاس نمایی از تمام صفحات سند ایجاد می‌کند.

کلاس HtmlViewOptions گزینه‌هایی را برای رندر کردن اسناد به فرمت HTML ارائه می‌دهد. متد سازنده ForEmbeddedResources یک نمونه جدید از کلاس HtmlViewOptions ایجاد می‌کند تا به HTML با منابع جاسازی شده رندر کند. همانطور که می‌بینید، من مسیر فایل خروجی را در مثال کد ارائه داده‌ام.

شما می‌توانید جزئیات بیشتری درباره `Document HTML Viewer” در مستندات پیدا کنید.

فولد خاص را از بایگانی‌های ZIP در HTML رندر کنید

شما می‌توانید یک پوشه خاص را که در داخل فایل ZIP قرار دارد با دنبال کردن مراحل ساده زیر به HTML تبدیل کنید:

1. یک نمونه از کلاس Viewer را ایجاد کنید
2. Provide the input file path
3. یک نمونه از HtmlViewOptions کلاس ایجاد کنید
4. Provide output file path
5. نام پوشه را به render تنظیم کنید
6. متد View() را فراخوانی کنید و HtmlViewOptions را منتقل کنید.

نمونه کد زیر نشان می‌دهد که چگونه یک پوشه خاص از فایل ZIP را در HTML با استفاده از C# نمایش دهیم.

// initialize viewer
Viewer viewer = new Viewer("C:\\Files\\sample.zip");

// تعریف گزینه‌های نمایشی HTML
HtmlViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources("C:\\Files\\output.html");
// set folder name
viewOptions.ArchiveOptions.Folder = "ThirdFolderWithItems";

// create view
viewer.View(viewOptions);

کلاس ArchiveOptions گزینه‌هایی برای رندر کردن فایل‌های آرشیو ارائه می‌دهد. این امکان را فراهم می‌کند که یک پوشه خاص را از آرشیوهای ZIP با ارائه نام پوشه موجود در داخل آرشیو رندر کنید.

محتوای آرشیوهای ZIP را در PDF مشاهده کنید

شما می‌توانید فایل ZIP را با دنبال کردن مراحل ساده زیر به سند PDF تبدیل کنید:

1. یک نمونه از کلاس Viewer را ایجاد کنید
2. Provide the input file path
3. یک نمونه از PdfViewOptions کلاس ایجاد کنید
4. Provide output file path
5. متد View() را فراخوانی کنید و PdfViewOptions را ارسال کنید.

کد نمونه زیر نشان می‌دهد که چگونه فایل ZIP را در PDF با استفاده از C# رندر کنیم.

// initialize viewer
Viewer viewer = new Viewer("C:\\Files\\sample.zip");

// تعریف گزینه‌های مشاهده PDF
PdfViewOptions options = new PdfViewOptions("C:\\Files\\output.pdf");

// create view
viewer.View(viewOptions);

کلاس PdfViewOptions گزینه‌هایی برای رندرینگ اسناد به فرمت PDF ارائه می‌دهد. می‌توانید جزئیات بیشتری در مورد `Document PDF Viewer” در مستندات پیدا کنید.

ZIP آرشیوها را به JPG تبدیل کنید

شما می‌توانید فایل ZIP را به تصویر JPG تبدیل کنید با دنبال کردن مراحل ساده زیر:

1. یک نمونه از کلاس Viewer را ایجاد کنید
2. Provide the input file path
3. یک نمونه از JpgViewOptions کلاس ایجاد کنید
4. Provide output file path
5. متد View() را صدا کنید و JpgViewOptions را عبور دهید.

نمونه کد زیر نشان می‌دهد که چگونه فایل ZIP را به تصویر JPG با استفاده از C# رندر کنیم.

// initialize viewer
Viewer viewer = new Viewer("C:\\Files\\sample.zip");

// تنظیمات نمای JPG را تعریف کنید
JpgViewOptions options = new JpgViewOptions("C:\\Files\\output_page_{0}.jpg");

// create view
viewer.View(viewOptions);

شما می‌توانید اسناد را به فرمت‌های تصویر JPG یا PNG تبدیل کنید. کلاس JpgViewOptions گزینه‌هایی را برای تبدیل اسناد به فرمت JPG ارائه می‌دهد. به همین ترتیب، کلاس PngViewOptions گزینه‌هایی را برای تبدیل اسناد به فرمت PNG ارائه می‌دهد.

شما می توانید اطلاعات بیشتری در مورد `Document Image Viewer” در مستندات بیابید.

فهرستی از پوشه‌ها را از آرشیوهای ZIP دریافت کنید

شما می‌توانید به‌صورت برنامه‌نویسی فهرستی از تمام پوشه‌ها و زیرپوشه‌ها را از فایل ZIP دریافت کنید با دنبال کردن مراحل زیر:

1. یک نمونه از کلاس Viewer را ایجاد کنید
2. Provide the input file path
3. Create ViewInfoOptions
4. Create ViewInfo instance by calling GetViewInfo() method
5. دریافت ArchiveViewInfo
6. Show the results

کد نمونه زیر نشان می‌دهد که چگونه می‌توان از فایل ZIP یک لیست از پوشه‌ها را با استفاده از C# به دست آورد.

// initialize viewer
Viewer viewer = new Viewer("C:\\Files\\sample.zip");

// create view info options
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;

// get view info
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. Provide the input file path
3. یک نمونه از PdfViewOptions کلاس ایجاد کنید
4. Provide output file path
5. نام فایل جدید را برای نمایش تنظیم کنید
6. متد View() را فراخوانی کنید و PdfViewOptions را ارسال کنید

کد نمونه زیر نشان می‌دهد چگونه می‌توان نام فایل ZIP را در حین رندر با استفاده از C# تغییر داد.

// مشاهده کننده را راه‌اندازی کنید.
Viewer viewer = new Viewer("C:\\Files\\sample.zip");

// تعریف گزینه‌های نمایش PDF
PdfViewOptions viewOptions = new PdfViewOptions("C:\\Files\\output.pdf");
// set new file name
viewOptions.ArchiveOptions.FileName = new FileName("MyFiles");

viewer.View(viewOptions);

کلاس ArchiveOptions خصوصیت FileName را فراهم می‌کند که برای نمایش نام فایل در هدر استفاده می‌شود. شما می‌توانید یک نام نمایش جدید تنظیم کنید همان‌طور که در مثال کد بالا نشان داده شده است. به‌طور پیش‌فرض، نام فایل منبع را نمایش می‌دهد.

یک مجوز رایگان بگیرید

شما می‌توانید API را بدون محدودیت‌های ارزیابی با درخواست یک مجوز موقت رایگان امتحان کنید.

نتیجه گیری

در این مقاله، شما یاد گرفتید که چگونه آرشیوهای ZIP را با استفاده از C# ارائه دهید. شما همچنین یاد گرفتید که چگونه محتوای فایل‌های ZIP را به HTML، PDF و تصاویر JPG تبدیل و نمایش دهید. علاوه بر این، شما یاد گرفتید که چگونه به‌صورت برنامه‌نویسی لیستی از پوشه‌ها و زیرپوشه‌ها را از آرشیو ZIP دریافت کنید. می‌توانید اطلاعات بیشتری در مورد GroupDocs.Viewer برای API .NET با استفاده از documentation بیاموزید. در صورت هرگونه ابهام، لطفاً با ما در forum تماس بگیرید.

همچنین ببینید

• View CAD files in C# using .NET API
• پخش و توقف انیمیشن GIF و تصاویر APNG با استفاده از C#