التحكم في الموارد الخارجية في Excel إلى PDF في Aspose.Cells

مقدمة

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

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

قبل أن ننتقل إلى التفاصيل الدقيقة، دعنا نتأكد من أنك تمتلك كل ما تحتاجه للبدء. إليك قائمة مرجعية سريعة:

1. Visual Studio أو أي بيئة تطوير متكاملة متوافقة مع .NET: ستحتاج إلى بيئة لكتابة واختبار التعليمات البرمجية الخاصة بك.
2. Aspose.Cells لـ .NET: إذا لم تقم بتثبيته بعد، فتوجه إلىتنزيلات Aspose الصفحة والحصول على الإصدار الأحدث.
3. المعرفة الأساسية بلغة C#: ستكون المعرفة بلغة البرمجة C# مفيدة. إذا لم تكن متأكدًا من أي مفاهيم، فلا تتردد في البحث عنها.
4. ملف Excel نموذجي: قم بإعداد ملف Excel باستخدام أي موارد خارجية ترغب في تحويلها. يمكنك استخدام ملف العينة المقدم “samplePdfSaveOptions_StreamProvider.xlsx”.
5. ملف صورة للاختبار: سيتم استخدامه كمورد خارجي أثناء التحويل. ملف الصورة “newPdfSaveOptions_StreamProvider.png” هو بديل جيد.

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

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

using System.IO;
using System.Drawing;
using System.Drawing.Imaging;
using Aspose.Cells;
using Aspose.Cells.Drawing;
using Aspose.Cells.Rendering;
using System;

ستوفر لك هذه الحزم جميع الفئات والأساليب الأساسية التي ستحتاجها لأداء مهامك.

الخطوة 1: إنشاء فئة موفر البث الخاص بك

أول أمر يجب عليك القيام به هو إنشاء فئة موفر البث التي تنفذIStreamProvider ستتيح لك هذه الفئة التحكم في كيفية تحميل الموارد الخارجية.

class MyStreamProvider : IStreamProvider
{
    public void CloseStream(StreamProviderOptions options)
    {
        Debug.WriteLine("-----Close Stream-----");
    }
    public void InitStream(StreamProviderOptions options)
    {
        string sourceDir = "Your Document Directory";
        Debug.WriteLine("-----Init Stream-----");
        // قراءة الصورة الجديدة في مجرى الذاكرة وتعيينها إلى خاصية المجرى
        byte[] bts = File.ReadAllBytes(sourceDir + "newPdfSaveOptions_StreamProvider.png");
        MemoryStream ms = new MemoryStream(bts);
        options.Stream = ms;
    }
}

في هذه الفئة:

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

الخطوة 2: إعداد أدلة المصدر والإخراج

الآن بعد أن أصبح موفر البث الخاص بك جاهزًا، فقد حان الوقت لتحديد مكان وجود ملف Excel والمكان الذي تريد حفظ ملف PDF فيه.

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

ببساطة استبدل"Your Document Directory" مع المسار الفعلي على جهاز الكمبيوتر الخاص بك حيث توجد ملفاتك. يعد الحفاظ على تنظيم ملفاتك أمرًا بالغ الأهمية!

الخطوة 3: تحميل ملف Excel الخاص بك

بعد ذلك، ستقوم بتحميل ملف Excel الذي تريد إنشاء ملف PDF منه.

// تحميل ملف Excel المصدر الذي يحتوي على صور خارجية
Workbook wb = new Workbook(sourceDir + "samplePdfSaveOptions_StreamProvider.xlsx");

نحن نستخدمWorkbook الفئة من Aspose.Cells، والتي تمثل ملف Excel الخاص بك. يمكن أن يتضمن الملف موارد خارجية متنوعة مثل الصور التي تريد التحكم فيها أثناء التحويل.

الخطوة 4: تعيين خيارات حفظ PDF

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

// تحديد خيارات حفظ ملف PDF - موفر البث
PdfSaveOptions opts = new PdfSaveOptions();
opts.OnePagePerSheet = true; // احفظ كل ورقة في صفحة جديدة

هنا، نقوم بإنشاء مثيل جديد لـPdfSaveOptions ، مما يسمح لك بتخصيص كيفية تنسيق ملف PDF الخاص بك.OnePagePerSheetيعد هذا الخيار مفيدًا لضمان حصول كل ورقة Excel على صفحة خاصة بها في ملف PDF النهائي.

الخطوة 5: تعيين موفر البث الخاص بك

بعد تعيين خيارات PDF الخاصة بك، يتعين عليك إخبار Aspose باستخدام موفر البث المخصص للموارد الخارجية.

wb.Settings.StreamProvider = new MyStreamProvider();

هذا الخط يربطكWorkbook مثال معMyStreamProvider الفئة التي أنشأتها سابقًا. وهذا يعني أنه عند مواجهة موارد خارجية أثناء التحويل، سيتعامل معها مزود الخدمة الخاص بك كما هو محدد.

الخطوة 6: احفظ المصنف بصيغة PDF

بعد إعداد كل شيء، حان الوقت أخيرًا لحفظ مصنف Excel الخاص بك بتنسيق PDF.

// حفظ المصنف بصيغة Pdf
wb.Save(outputDir + "outputPdfSaveOptions_StreamProvider.pdf", opts);

من خلال الاتصالSave من خلال تطبيق الطريقة على كائن المصنف وتمرير دليل الإخراج الخاص بك مع خيارات PDF، يمكنك تحويل ملف Excel إلى ملف PDF منسق بشكل جميل.

الخطوة 7: تأكيد التنفيذ الناجح

ولاختتام الأمر، من الجميل دائمًا التأكد من نجاح عمليتك!

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

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

خاتمة

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

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

ما هو Aspose.Cells؟

Aspose.Cells هي مكتبة قوية لمطوري .NET تتيح لك إنشاء ملفات Excel ومعالجتها وتحويلها وعرضها بتنسيقات مختلفة.

كيف يمكنني تنزيل Aspose.Cells؟

يمكنك تنزيل أحدث إصدار من Aspose.Cells منرابط التحميل.

هل يمكنني تجربة Aspose.Cells مجانًا؟

نعم! يمكنك الحصول على نسخة تجريبية مجانية من خلال زيارةصفحة التجربة المجانية.

أين يمكنني العثور على الدعم لـ Aspose.Cells؟

لأي استفسارات تتعلق بالدعم، يمكنك زيارةمنتدى دعم Aspose.

كيف يمكنني الحصول على ترخيص مؤقت لـ Aspose.Cells؟

يمكنك التقدم بطلب للحصول على ترخيص مؤقتهنا.