LoadOptions

LoadOptions class

يسمح بتحديد خيارات إضافية (مثل كلمة المرور أو URI الأساسي) عند تحميل مستند إلى ملفDocument الكائن.

لمعرفة المزيد، قم بزيارةتحديد خيارات التحميل مقالة توثيقية.

public class LoadOptions

المنشئون

اسموصف
LoadOptions()تهيئة مثيل جديد لهذه الفئة بالقيم الافتراضية.
LoadOptions(string)اختصار لتهيئة مثيل جديد لهذه الفئة بكلمة المرور المحددة لتحميل مستند مشفر.
LoadOptions(LoadFormat, string, string)اختصار لتهيئة مثيل جديد لهذه الفئة مع تعيين الخصائص على القيم المحددة.

الخصائص

اسموصف
BaseUri { get; set; }الحصول على أو تعيين السلسلة التي سيتم استخدامها لتحليل معرفات URI النسبية الموجودة في المستند إلى معرفات URI مطلقة عند الحاجة. يمكن أن يكونباطل أو سلسلة فارغة. الافتراضي هوباطل .
ConvertMetafilesToPng { get; set; }يحصل على أو يحدد ما إذا كان سيتم تحويل ملف التعريف (Wmf أوEmf ) الصور لPng تنسيق الصورة.
ConvertShapeToOfficeMath { get; set; }الحصول على أو تعيين ما إذا كان سيتم تحويل الأشكال باستخدام EquationXML إلى كائنات Office Math.
Encoding { get; set; }الحصول على أو تعيين التشفير الذي سيتم استخدامه لتحميل مستند HTML أو TXT أو CHM إذا لم يتم تحديد التشفير داخل المستند. يمكن أن يكونباطل . الافتراضي هوباطل .
FontSettings { get; set; }يسمح بتحديد إعدادات خط المستند.
IgnoreOleData { get; set; }يحدد ما إذا كان سيتم تجاهل بيانات OLE أم لا.
LanguagePreferences { get; }يحصل على تفضيلات اللغة التي سيتم استخدامها عند تحميل المستند.
LoadFormat { get; set; }يحدد تنسيق المستند الذي سيتم تحميله. الافتراضي هوAuto .
MswVersion { get; set; }يسمح بتحديد أن عملية تحميل المستند يجب أن تتطابق مع إصدار معين من MS Word. القيمة الافتراضية هيWord2019
Password { get; set; }الحصول على كلمة المرور أو تعيينها لفتح مستند مشفر. يمكن أن يكونباطل أو سلسلة فارغة. الافتراضي هوباطل .
PreserveIncludePictureField { get; set; }الحصول على أو تعيين ما إذا كان سيتم الاحتفاظ بحقل INCLUDEPICTURE عند قراءة تنسيقات Microsoft Word. القيمة الافتراضية هيخطأ شنيع .
ProgressCallback { get; set; }يتم الاتصال به أثناء تحميل مستند ويقبل البيانات المتعلقة بتقدم التحميل.
ResourceLoadingCallback { get; set; }يسمح بالتحكم في كيفية تحميل الموارد الخارجية (الصور، أوراق الأنماط) عند استيراد مستند من HTML، MHTML.
TempFolder { get; set; }يسمح باستخدام الملفات المؤقتة عند قراءة المستند. بشكل افتراضي هذه الخاصية هيباطل ولا يتم استخدام أي ملفات مؤقتة.
UpdateDirtyFields { get; set; }يحدد ما إذا كان سيتم تحديث الحقول ذات الامتداد أم لامتسخ السمة.
WarningCallback { get; set; }يتم استدعاؤه أثناء عملية التحميل، عند اكتشاف مشكلة قد تؤدي إلى فقدان دقة البيانات أو التنسيق.

طُرق

اسموصف
override Equals(object)

أمثلة

يوضح كيفية تحميل مستند Microsoft Word المشفر.

Document doc;

// Aspose.Words يطرح استثناءً إذا حاولنا فتح مستند مشفر بدون كلمة المرور الخاصة به.
Assert.Throws<IncorrectPasswordException>(() => doc = new Document(MyDir + "Encrypted.docx"));

// عند تحميل مثل هذا المستند، يتم تمرير كلمة المرور إلى مُنشئ المستند باستخدام كائن LoadOptions.
LoadOptions options = new LoadOptions("docPassword");

// هناك طريقتان لتحميل مستند مشفر باستخدام كائن LoadOptions.
// 1 - قم بتحميل المستند من نظام الملفات المحلي حسب اسم الملف:
doc = new Document(MyDir + "Encrypted.docx", options);
// 2 - تحميل المستند من الدفق:
using (Stream stream = File.OpenRead(MyDir + "Encrypted.docx"))
{
    doc = new Document(stream, options);
}

أنظر أيضا