تحديد خيارات التحميل
عند تحميل مستند، يمكنك تعيين بعض الخصائص المتقدمة. يوفر لك Aspose.Words فئة LoadOptions، والتي تسمح بتحكم أكثر دقة في عملية التحميل. تحتوي بعض تنسيقات التحميل على فئة مقابلة تحتوي على خيارات التحميل لتنسيق التحميل هذا، على سبيل المثال، يوجد PdfLoadOptions للتحميل إلى تنسيق PDF أو TxtLoadOptions للتحميل إلى TXT. توفر هذه المقالة أمثلة على العمل مع خيارات فئة LoadOptions.
قم بتعيين إصدار Microsoft Word لتغيير المظهر
يمكن للإصدارات المختلفة من تطبيق Microsoft Word عرض المستندات بشكل مختلف. على سبيل المثال، هناك مشكلة معروفة في مستندات OOXML مثل DOCX أو DOTX التي يتم إنتاجها باستخدام WPS Office. في مثل هذه الحالة، قد تكون عناصر ترميز المستند الأساسية مفقودة أو قد يتم تفسيرها بشكل مختلف مما يتسبب في عرض Microsoft Word 2019 لمثل هذا المستند بشكل مختلف مقارنةً بـ Microsoft Word 2010.
افتراضيًا، يفتح Aspose.Words المستندات باستخدام قواعد Microsoft Word 2019. إذا كنت بحاجة إلى إظهار تحميل المستند كما يحدث في أحد إصدارات تطبيق Microsoft Word السابقة، فيجب عليك تحديد الإصدار المطلوب بشكل صريح باستخدام خاصية MswVersion لفئة LoadOptions.
يوضح مثال التعليمات البرمجية التالي كيفية تعيين إصدار Microsoft Word مع خيارات التحميل:
اضبط تفضيلات اللغة لتغيير المظهر
لا تعتمد تفاصيل عرض مستند في Microsoft Word على إصدار التطبيق وقيمة خاصية MswVersion فحسب، بل تعتمد أيضًا على إعدادات اللغة. قد يعرض Microsoft Word المستندات بشكل مختلف اعتمادًا على إعدادات الحوار “تفضيلات لغة المكتب”، والتي يمكن العثور عليها في “ملف → خيارات → اللغة”. باستخدام مربع الحوار هذا، يمكن للمستخدم تحديد، على سبيل المثال، اللغة الأساسية ولغات التدقيق ولغات العرض وما إلى ذلك. يوفر Aspose.Words خاصية LanguagePreferences كمكافئة لمربع الحوار هذا. إذا كان مخرج Aspose.Words يختلف عن مخرج Microsoft Word، فقم بتعيين القيمة المناسبة لـ EditingLanguage - يمكن أن يؤدي ذلك إلى تحسين مستند الإخراج.
يوضح مثال التعليمات البرمجية التالي كيفية تعيين اللغة اليابانية كـ EditingLanguage:
استخدم WarningCallback للتحكم في المشكلات أثناء تحميل المستند
قد تكون بعض المستندات تالفة، أو تحتوي على إدخالات غير صالحة، أو تحتوي على ميزات لا يدعمها Aspose.Words حاليًا. إذا كنت تريد التعرف على المشكلات التي حدثت أثناء تحميل مستند، فإن Aspose.Words يوفر واجهة IWarningCallback.
يوضح مثال الكود التالي تنفيذ واجهة IWarningCallback:
للحصول على معلومات حول جميع المشاكل طوال وقت التحميل، استخدم خاصية WarningCallback.
يوضح مثال التعليمات البرمجية التالي كيفية استخدام هذه الخاصية:
استخدم ResourceLoadingCallback للتحكم في تحميل الموارد الخارجية
قد يحتوي المستند على روابط خارجية لصور موجودة في مكان ما على القرص المحلي أو الشبكة أو الإنترنت. يقوم Aspose.Words تلقائيًا بتحميل هذه الصور في المستند، ولكن هناك حالات تحتاج فيها هذه العملية إلى التحكم. على سبيل المثال، لنقرر ما إذا كنا نحتاج حقًا إلى تحميل صورة معينة أو ربما تخطيها. يتيح لك خيار تحميل ResourceLoadingCallback التحكم في هذا.
يوضح مثال الكود التالي تنفيذ واجهة IResourceLoadingCallback:
يوضح مثال التعليمات البرمجية التالي كيفية استخدام خاصية ResourceLoadingCallback:
استخدم TempFolder لتجنب استثناء الذاكرة
يدعم Aspose.Words المستندات الكبيرة جدًا التي تحتوي على آلاف الصفحات المليئة بالمحتوى الغني. قد يتطلب تحميل مثل هذه المستندات قدرًا كبيرًا من ذاكرة الوصول العشوائي. في عملية التحميل، يحتاج Aspose.Words إلى المزيد من الذاكرة للاحتفاظ بالهياكل المؤقتة المستخدمة لتحليل المستند.
إذا كانت لديك مشكلة في استثناء نفاد الذاكرة أثناء تحميل مستند، فحاول استخدام خاصية TempFolder. في هذه الحالة، سيقوم Aspose.Words بتخزين بعض البيانات في ملفات مؤقتة بدلاً من الذاكرة، وهذا يمكن أن يساعد في تجنب مثل هذا الاستثناء.
يوضح مثال التعليمات البرمجية التالي كيفية تعيين TempFolder:
اضبط الترميز بشكل صريح
تقوم معظم تنسيقات المستندات الحديثة بتخزين محتواها بتنسيق Unicode ولا تتطلب معالجة خاصة. من ناحية أخرى، لا يزال هناك العديد من المستندات التي تستخدم بعض ترميز ما قبل Unicode وفي بعض الأحيان إما تفوت معلومات الترميز أو لا تدعم حتى معلومات الترميز بطبيعتها. يحاول Aspose.Words اكتشاف الترميز المناسب تلقائيًا بشكل افتراضي، ولكن في حالة نادرة قد تحتاج إلى استخدام ترميز مختلف عن الذي اكتشفته خوارزمية التعرف على الترميز لدينا. في هذه الحالة، استخدم خاصية Encoding للحصول على الترميز أو تعيينه.
يوضح مثال التعليمات البرمجية التالي كيفية تعيين الترميز لتجاوز الترميز المختار تلقائيًا:
تحميل المستندات المشفرة
يمكنك تحميل مستندات Word مشفرة بكلمة مرور. للقيام بذلك، استخدم التحميل الزائد للمنشئ الخاص الذي يقبل كائن LoadOptions. يحتوي هذا الكائن على خاصية Password، التي تحدد سلسلة كلمة المرور.
يوضح مثال التعليمات البرمجية التالي كيفية تحميل مستند مشفر بكلمة مرور:
إذا كنت لا تعرف مقدمًا ما إذا كان الملف مشفرًا، فيمكنك استخدام فئة FileFormatUtil، التي توفر طرقًا مفيدة للعمل مع تنسيقات الملفات، مثل اكتشاف تنسيق الملف أو تحويل امتدادات الملفات إلى/من تعدادات تنسيقات الملفات. لاكتشاف ما إذا كان المستند مشفرًا ويتطلب كلمة مرور لفتحه، استخدم خاصية IsEncrypted.
يوضح مثال التعليمات البرمجية التالي كيفية التحقق من OpenDocument سواء كان مشفرًا أم لا: