LoadOptions

LoadOptions class

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

public class LoadOptions

المنشئون

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

الخصائص

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

أمثلة

يوضح كيفية تحميل مستند 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);

أنظر أيضا