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);
}
أنظر أيضا
- مساحة الاسم Aspose.Words.Loading
- المجسم Aspose.Words
