استكشاف الأخطاء وإصلاحها Aspose.Words FOSS for .NET

تغطي هذه الصفحة المشكلات الشائعة التي تُواجه عند بناء واستخدام Aspose.Words FOSS لـ .NET، وكيفية حلها.

مشكلات البناء والتثبيت

dotnet add package Aspose.Words لا يمكنه العثور على الحزمة

هذا الأمر يُشير إلى حزمة Aspose.Words التجارية، وليس إصدار FOSS — معرف حزمة FOSS هو Aspose.Words.FOSS:

dotnet add package Aspose.Words.FOSS

بدلاً من ذلك، نفّذ git clone للحصول على المصدر، ثم cd داخل المجلد المستنسخ وشغّل dotnet build على الحل:

git clone https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git
cd Aspose.Words-FOSS-for-.NET
dotnet build Aspose.Words.sln -c Release

ثم أضف إشارة مشروع إلى Aspose.Words.csproj من تطبيقك الخاص بدلاً من إشارة حزمة.

إشارة المشروع لا تُحل بعد الاستنساخ

تأكد من أن الإشارة تشير إلى Aspose.Words.csproj داخل مجلد Aspose.Words-FOSS-for-.NET/Aspose.Words/ المستنسخ، وأن الحل تم بناؤه بنجاح أولًا (dotnet build Aspose.Words.sln -c Release). المكتبة تستهدف .NET Standard 2.0، لذا يمكن لأي SDK يستهدف .NET Framework 4.6.2+ أو .NET 6/8/10 الإشارة إليها.

مشكلات التحميل

UnsupportedFileFormatException عند تحميل مستند

UnsupportedFileFormatException يُرمى أثناء التحميل عندما لا يتم التعرف على تنسيق الملف أو لا يدعمه هذا الإصدار. تنسيقات التحميل في هذا الإصدار هي DOCX و DOCM و DOTX و DOTM و Flat OPC و Markdown والنص العادي — تمرير مسار غير مدعوم مثل input.doc إلى مُنشئ Document يسبب هذا الاستثناء بدلاً من إرجاع مستند محمَّل:

using Aspose.Words;

try
{
    Document doc = new Document("input.doc");
}
catch (UnsupportedFileFormatException ex)
{
    Console.WriteLine("Format not supported by this edition: " + ex.Message);
}

التقاط UnsupportedFileFormatException حول مُنشئ Document يتيح لك إبلاغ رسالة واضحة بدلاً من السماح للاستثناء بالانتشار كأثر مكدس غير معالج.

FileCorruptedException على ملف يبدو صالحًا

يتم إلقاء FileCorruptedException أثناء التحميل عندما يبدو الملف تالفًا ولا يمكن تحليله — على سبيل المثال، ملف .docx ليس حزمة OOXML قائمة على ZIP صالحة، أو ملف تم قطعه أثناء النقل. أعد الحصول على الملف من مصدره وتأكد من أنه يفتح بشكل صحيح قبل تحميله باستخدام Document.

IncorrectPasswordException عند فتح مستند محمي

يتم إلقاؤه عندما يكون المستند مشفرًا بكلمة مرور وتكون كلمة المرور المقدمة إلى التحميل الزائد LoadOptions لمُنشئ Document مفقودة أو غير صحيحة. قدم كلمة المرور الصحيحة عبر LoadOptions.Password قبل التحميل.

مشكلات الحفظ والتصدير

يفشل Document.Save() إلى PDF أو XPS أو امتداد صورة

هذا الإصدار لا يتضمن نظام تخطيط الصفحات وإخراج الرسوم، لذا لا يمكن لـ Document.Save() التصدير إلى صيغ PDF أو XPS أو الصور.

احفظ إلى DOCX، DOCM، DOTX، DOTM، Flat OPC، Markdown، أو نص عادي بدلاً من ذلك — هذه هي الصيغ التي يكتبها هذا الإصدار فعليًا. التجاري Aspose.Words لـ .NET يضيف PDF و XPS وإخراج الصور.

دائمًا ما تُظهر أرقام الصفحات وإدخالات جدول المحتويات القيمة 0

Aspose.Words FOSS لـ .NET يتضمن محرك تقييم حقول كامل، لذا تُحدَّث حقول المحتوى مثل DATE وDOCPROPERTY بشكل صحيح. الحقول التي تعتمد على تخطيط الصفحة — أرقام الصفحات، NUMPAGES، وإدخالات الفهرس — تُقَيِّم إلى عنصر نائب 0 بدلاً من قيمة محسوبة، لأن هذا الإصدار لا يتضمن محرك التخطيط الذي عادةً ما يرقم المستند. هذا سلوك متوقع في هذا الإصدار، ليس خطأ.

مشكلات التوقيع الرقمي

توقيع المستند لا يُحدث أي تأثير

DigitalSignatureUtil.Sign() وواجهات برمجة التطبيقات المتعلقة بالتوقيع موجودة في نموذج الكائن لضمان التوافق البنيوي مع المنتج التجاري، لكن إنشاء توقيع جديد غير فعال في هذا الإصدار FOSS — استدعاؤها لا ينتج مخرجات موقّعة. يمكن لهذا الإصدار فحص والتحقق من التوقيعات المرفقة بالفعل بمستند عبر Document.DigitalSignatures وDigitalSignatureUtil.LoadSignatures()، لكن سير عمل التوقيع يحتاج إلى Aspose.Words التجاري لـ .NET.

مشكلات الخطوط

الخطوط المضمَّنة أكبر من المتوقع

عند تمكين EmbedTrueTypeFonts، تُضمّن الخطوط كملفات كاملة بدلاً من تقليلها إلى الأحرف المستخدمة فعليًا في المستند فقط، لذا فإن الملفات المحفوظة التي تضمّن خطوطًا تكون أكبر من النتيجة المكافئة من المنتج التجاري. لا يوجد حل بديل في هذا الإصدار — تقليل حجم الخطوط المضمَّنة غير متضمن.