عرض الصفحات المتسلسلة في Aspose.Cells

مقدمة

يمكن أن يكون عرض صفحات معينة من مصنف Excel مفيدًا بشكل لا يصدق، خاصةً عندما تحتاج فقط إلى صور بيانات معينة دون الملف بالكامل. Aspose.Cells for .NET هي مكتبة قوية توفر التحكم الدقيق في مستندات Excel في تطبيقات .NET، مما يجعل من الممكن عرض صفحات محددة وتغيير التنسيقات والمزيد. يرشدك هذا البرنامج التعليمي خلال تحويل صفحات ورقة عمل Excel معينة إلى تنسيقات صور - مثالية لإنشاء لقطات بيانات مخصصة.

المتطلبات الأساسية

قبل القفز إلى الكود، تأكد من إعداد العناصر التالية:

• مكتبة Aspose.Cells لـ .NET: يمكنكتحميله هنا.
• بيئة التطوير: أي بيئة تدعم .NET مثل Visual Studio.
• ملف Excel: ملف Excel نموذجي يحتوي على صفحات متعددة، محفوظ في الدليل المحلي لديك. بالإضافة إلى ذلك، تأكد من الحصول على نسخة تجريبية مجانية أو شراء ترخيص إذا لم يكن لديك ترخيص. تحقق منرخصة مؤقتة لاستكشاف الميزات الكاملة قبل إجراء عملية شراء.

استيراد الحزم

للبدء، سنحتاج إلى استيراد Aspose.Cells وأي مساحات أسماء ضرورية في بيئة .NET الخاصة بك.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using Aspose.Cells.Rendering;

توفر هذه الحزم جميع الفئات والطرق المطلوبة لمعالجة ملفات Excel وعرضها. الآن، دعنا نتناول كل جزء من عملية العرض بالتفصيل.

الخطوة 1: إعداد دليل المصدر والإخراج

أولاً، نقوم بتحديد الدلائل لملفات الإدخال والإخراج، لضمان أن برنامجنا يعرف مكان استرداد الملفات وتخزينها.

// دليل المصدر
string sourceDir = "Your Document Directory";
// دليل الإخراج
string outputDir = "Your Document Directory";

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

الخطوة 2: تحميل ملف Excel النموذجي

بعد ذلك، نقوم بتحميل ملف Excel الخاص بنا باستخدام Aspose.CellsWorkbook سيحتوي هذا الملف على البيانات والصفحات التي نريد عرضها.

// تحميل ملف Excel النموذجي
Workbook wb = new Workbook(sourceDir + "sampleImageOrPrintOptions_PageIndexPageCount.xlsx");

الWorkbookتعتبر الفئة بمثابة معالج Excel الرئيسي في Aspose.Cells، حيث توفر الوصول المباشر إلى الأوراق والأنماط والمزيد.

الخطوة 3: الوصول إلى ورقة العمل المستهدفة

الآن، دعنا نحدد ورقة العمل المحددة التي نريد العمل عليها. في هذا البرنامج التعليمي، سنستخدم الورقة الأولى، ولكن يمكنك تعديلها إلى أي ورقة تحتاجها.

// الوصول إلى ورقة العمل الأولى
Worksheet ws = wb.Worksheets[0];

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

الخطوة 4: إعداد خيارات الصورة أو الطباعة

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

// تحديد خيارات الصورة أو الطباعة
ImageOrPrintOptions opts = new ImageOrPrintOptions();
opts.PageIndex = 3; // ابدأ من الصفحة 4
opts.PageCount = 4; // تقديم أربع صفحات
opts.ImageType = Drawing.ImageType.Png;

معImageOrPrintOptions ، يمكنك ضبطPageIndex (الصفحة الافتتاحية)PageCount (عدد الصفحات المطلوب عرضها) وImageType (تنسيق الإخراج). يتيح لك هذا الإعداد التحكم الدقيق في عملية العرض.

الخطوة 5: إنشاء كائن عرض الورقة

الآن، نقوم بإنشاءSheetRender الكائن الذي سيأخذ ورقة العمل وخيارات الصورة الخاصة بنا ويعرض كل صفحة محددة كصورة.

// إنشاء كائن عرض الورقة
SheetRender sr = new SheetRender(ws, opts);

الSheetRender تُعد الفئة ضرورية لتحويل أوراق العمل إلى صور أو ملفات PDF أو تنسيقات أخرى. فهي تستخدم ورقة العمل والخيارات التي قمت بتكوينها لتوليد المخرجات.

الخطوة 6: عرض كل صفحة وحفظها كصورة

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

// طباعة كافة الصفحات كصور
for (int i = opts.PageIndex; i < sr.PageCount; i++)
{
    sr.ToImage(i, outputDir + "outputImage-" + (i + 1) + ".png");
}

فيما يلي تفصيل لما يحدث:

• الfor تمر الحلقة عبر كل صفحة في النطاق المحدد.
• ToImage يتم استخدامه لتقديم كل صفحة كصورة، مع تنسيق اسم ملف مخصص لتمييز كل صفحة.

الخطوة 7: تأكيد الإكمال

أضف رسالة تأكيد بسيطة بمجرد اكتمال العرض. هذه الخطوة اختيارية ولكنها قد تكون مفيدة للتحقق من التنفيذ الناجح.

Console.WriteLine("RenderLimitedNoOfSequentialPages executed successfully.\r\n");

يؤكد هذا السطر الأخير أن كل شيء سار كما هو مقصود. سترى هذه الرسالة في وحدة التحكم الخاصة بك بعد عرض جميع الصفحات وحفظها.

خاتمة

والآن، لقد انتهيت! إن عرض صفحات معينة في مصنف Excel باستخدام Aspose.Cells for .NET هو طريقة مباشرة ولكنها قوية لتخصيص مخرجات البيانات. سواء كنت بحاجة إلى لقطة من المقاييس الرئيسية أو صور بيانات محددة، فإن هذا البرنامج التعليمي يغطيك. باتباع هذه الخطوات، يمكنك الآن عرض أي صفحة أو نطاق من الصفحات من ملفات Excel الخاصة بك بتنسيقات صور جميلة. لا تتردد في استكشاف خيارات أخرى داخلImageOrPrintOptions وSheetRender لمزيد من التحكم. برمجة سعيدة!

الأسئلة الشائعة

هل يمكنني عرض أوراق عمل متعددة في نفس الوقت؟

نعم، يمكنك المرور عبرWorksheets جمع وتطبيق عملية العرض على كل ورقة على حدة.

ما هي التنسيقات الأخرى التي يمكنني عرض الصفحات بها بالإضافة إلى PNG؟

يدعم Aspose.Cells العديد من التنسيقات، بما في ذلك JPEG وBMP وTIFF وGIF. ما عليك سوى تغييرImageType فيImageOrPrintOptions.

كيف أتعامل مع ملفات Excel كبيرة الحجم ذات صفحات متعددة؟

بالنسبة للملفات الكبيرة، فكر في تقسيم العرض إلى أقسام أصغر لإدارة استخدام الذاكرة بشكل فعال.

هل من الممكن تخصيص دقة الصورة؟

نعم،ImageOrPrintOptions يسمح بتعيين DPI للدقة المخصصة باستخدامHorizontalResolution وVerticalResolution.

ماذا لو كنت بحاجة إلى عرض جزء من الصفحة فقط؟

يمكنك استخدامPrintArea الممتلكات فيPageSetup لتحديد مناطق محددة على ورقة العمل لعرضها.