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; } | يحدد ما إذا كان سيتم تحديث الحقول باستخداممتسخ السمة. |
| UseSystemLcid { get; set; } | يحصل على أو يحدد ما إذا كان سيتم استخدام قيمة LCID التي تم الحصول عليها من سجل Windows لتحديد هوامش إعداد الصفحة الافتراضية. |
| 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
