Class LoadOptions

اسم الفضاء : Aspose.Words.Loading تجميع: Aspose.Words.dll (25.4.0)

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

لمعرفة المزيد، قم بزيارة Specify Load Options مقالة الوثائق .

public class LoadOptions

Inheritance

object ← LoadOptions

Derived

ChmLoadOptions , HtmlLoadOptions , MarkdownLoadOptions , PdfLoadOptions , RtfLoadOptions , TxtLoadOptions

الأعضاء الموروثين

object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()

Constructors

LoadOptions()

يبدأ حالة جديدة من هذه الفئة مع القيم الافتراضية.

public LoadOptions()

LoadOptions(الستار)

قصة قصيرة لإطلاق مثال جديد من هذه الفئة مع كلمة المرور المحددة لتحميل وثيقة مشفرة.

public LoadOptions(string password)

Parameters

password string

كلمة المرور لفتح وثيقة مشفرة.يمكن أن تكون “صفر” أو شريط فارغ.

LoadOptions(كلمات مفتاحية, string, string)

قصة قصيرة لبدء حالة جديدة من هذه الفئة مع الخصائص المحددة للقيم المحددة.

public LoadOptions(LoadFormat loadFormat, string password, string baseUri)

Parameters

loadFormat LoadFormat

تنسيق الوثيقة التي يجب تحميلها.

password string

كلمة المرور لفتح وثيقة مشفرة.يمكن أن تكون “صفر” أو شريط فارغ.

baseUri string

الشريط الذي سيتم استخدامه لحل URI نسبي إلى مطلق.يمكن أن يكون “صفر” أو شريط فارغ.

Properties

BaseUri

يحصل أو يضع السلسلة التي سيتم استخدامها لحل URI النسبية الموجودة في الوثيقة في URIات مطلقة عند الضرورة.يمكن أن تكون “صفر” أو سلسلة فارغة.

public string BaseUri { get; set; }

قيمة الممتلكات

string

Remarks

يستخدم هذا الممتلكات لحل URI النسبي إلى مطلق في الحالات التالية:

• عند تحميل وثيقة HTML من تدفق وثيقة تحتوي على صور مع URI النسبية وليس لديها URI الأساسية المحددة في العنصر HTML الأساسية.
• عند حفظ وثيقة في PDF وغيرها من التنسيقات، لاسترداد الصور المرتبطة باستخدام URI نسبية بحيث يمكن حفظ الصور في وثيقة الإخراج.

ConvertMetafilesToPng

يحصل أو يحدد ما إذا كان لتحويل الميثافيل(Aspose.FileFormat.Wmf أو Aspose.FileFormat.Emf)صور إلى شكل صورة Aspose.FileFormat.Png.

public bool ConvertMetafilesToPng { get; set; }

قيمة الممتلكات

bool

Remarks

ميتافيلات (Aspose.FileFormat.Wmf أو Aspose.FileFormat.Emf)هو تنسيق الصورة غير المضغوط وأحيانا يتطلب الكثير من ذاكرة الوصول العشوائي للحفاظ على ومعالجة الوثيقة.هذا الخيار يسمح لك لتحويل جميع الصور الميتافيل إلى Aspose.FileFormat.Png على تحميل المستند.يرجى ملاحظة - تحويل الرسومات فيكتور إلى راستر يقلل من جودة الصور.

ConvertShapeToOfficeMath

يحصل أو يحدد ما إذا كان لتحويل الأشكال باستخدام EquationXML إلى كائنات Office Math.

public bool ConvertShapeToOfficeMath { get; set; }

قيمة الممتلكات

bool

Encoding

يحصل أو يضع الترميز الذي سيتم استخدامه لتحميل وثيقة HTML أو TXT أو CHM إذا لم يتم تحديد الترميز داخل الوثيقة.يمكن أن يكون “صفر”.

public Encoding Encoding { get; set; }

قيمة الممتلكات

Encoding

Remarks

يستخدم هذا الممتلكات فقط عند تحميل وثائق HTML أو TXT أو CHM.

إذا لم يتم تحديد التشفير داخل الوثيقة وهذه الخصائص ، فإن النظام سيحاول تلقائيًا اكتشاف التشفير.

FontSettings

يسمح بتحديد إعدادات الخط المستند.

public FontSettings FontSettings { get; set; }

قيمة الممتلكات

FontSettings

Remarks

عند تحميل بعض تنسيقات، قد تحتاج Aspose.Words لحل الخطوط.على سبيل المثال، عند تحميل مستندات HTML، قد تحل Aspose.Words الخطوط لتنفيذ الخطوط.

إذا قمت بتعيين ، سيتم استخدام إعدادات الخط الثابت الافتراضي Aspose.Words.Fonts.FontSettings.DefaultInstance.

القيمة الافتراضية هي.

IgnoreOleData

يحدد ما إذا كان يجب تجاهل بيانات OLE.

public bool IgnoreOleData { get; set; }

قيمة الممتلكات

bool

Remarks

يمكن تجاهل بيانات OLE أن يقلل من استهلاك الذاكرة ويزيد من الأداء دون فقدان البيانات في الحالة التي لا يدعم فيها تنسيق الوجهة كائنات OLE.

القيمة الافتراضية هي.

LanguagePreferences

يحصل على تفضيلات اللغة التي سيتم استخدامها عند تحميل المستند.

public LanguagePreferences LanguagePreferences { get; }

قيمة الممتلكات

LanguagePreferences

LoadFormat

يحدد شكل الوثيقة التي سيتم تحميلها.الافتراضي هو Aspose.Words.LoadFormat.Auto.

public LoadFormat LoadFormat { get; set; }

قيمة الممتلكات

LoadFormat

Remarks

من المستحسن أن تحدد قيمة Aspose.Words.LoadFormat.Auto واترك Aspose.Words اكتشاف تنسيق الملف تلقائيا.إذا كنت تعرف تنسيق المستند الذي كنت على وشك تحميل، يمكنك تحديد تنسيق صراحة وهذا سوف يقلل قليلا من وقت التحميل من قبل الجزء العلوي المرتبطة تلقائيا اكتشاف تنسيق.إذا كنت تحدد تنسيق التحميل صراحة وسوف يظهر أن يكون خاطئا، سيتم استدعاء الكشف التلقائي وسيتم إجراء محاولة ثانية لتحميل الملف.

MswVersion

يسمح بتحديد أن عملية تحميل المستند يجب أن تتطابق مع إصدار معين من MS Word.القيمة الافتراضية هي Aspose.Words.Settings.MsWordVersion.Word2019

public MsWordVersion MswVersion { get; set; }

قيمة الممتلكات

MsWordVersion

Remarks

يمكن أن تتعامل إصدارات Word المختلفة مع جوانب معينة من محتوى المستند وتصميمها بطريقة مختلفة قليلاً.أثناء عملية الشحن، والتي قد تؤدي إلى اختلافات صغيرة في نموذج الكائن المستند.

Password

يحصل أو يضع كلمة المرور لفتح وثيقة مشفرة.يمكن أن يكون “صفر” أو شريط فارغ.

public string Password { get; set; }

قيمة الممتلكات

string

Remarks

تحتاج إلى معرفة كلمة المرور لفتح وثيقة مشفرة.إذا لم يكن الوثيقة مشفرة، حدد هذا إلى أو سلك فارغ.

PreserveIncludePictureField

يحصل أو يحدد ما إذا كان للحفاظ على حقل INCLUDEPICTURE عند قراءة تنسيقات Microsoft Word.القيمة الافتراضية هي “مزيفة”.

public bool PreserveIncludePictureField { get; set; }

قيمة الممتلكات

bool

Remarks

من الناحية الافتراضية ، يتم تحويل حقل INCLUDEPICTURE إلى كائن شكل.يمكنك إعادة ترتيب أنه إذا كنت بحاجة إلى الحقل للحفاظ عليه ، على سبيل المثال ، إذا كنت ترغب في تحديثه برمجيًا.

واحدة من الحالات الممكنة للاستخدام قد تكون استخدام MERGEFIELD كحقل للأطفال لتغيير ديناميكي مسار المصدر للصورة.

ProgressCallback

يتم استدعاء أثناء تحميل وثيقة وقبول البيانات حول تقدم التحميل.

public IDocumentLoadingCallback ProgressCallback { get; set; }

قيمة الممتلكات

IDocumentLoadingCallback

Remarks

WL26_.LoadFormat.Docx, www.Wl26. LoadFormat.FlatOpc, W L26 .Lawformat .Dokm، _ www.wl26.Loyal.Otm. _ _ WL26, _ .LowFormate.Markdown ، _ wL66.Rtf , _ lw26_.loadformat.Software.

ResourceLoadingCallback

يتيح التحكم في كيفية تحميل الموارد الخارجية (الصور، ورقة النمط) عند استيراد وثيقة من HTML، MHTML.

public IResourceLoadingCallback ResourceLoadingCallback { get; set; }

قيمة الممتلكات

IResourceLoadingCallback

TempFolder

يسمح باستخدام الملفات المؤقتة عند قراءة المستند.بشكل افتراضي هذه الممتلكات صفر ولا يتم استخدام أي ملفات مؤقتة.

public string TempFolder { get; set; }

قيمة الممتلكات

string

Remarks

يجب أن يكون المجلد موجودًا ويمكن كتابته ، وإلا سيتم رمي استثناء.

يزيل Aspose.Words تلقائيًا جميع الملفات المؤقتة عند الانتهاء من القراءة.

UpdateDirtyFields

يحدد ما إذا كان لتحديث الحقول مع “القذرة” الخصائص.

public bool UpdateDirtyFields { get; set; }

قيمة الممتلكات

bool

UseSystemLcid

يحصل أو يحدد ما إذا كان لاستخدام قيمة LCID التي تم الحصول عليها من سجل Windows لتحديد هامش إعداد الصفحة الافتراضية.

public bool UseSystemLcid { get; set; }

قيمة الممتلكات

bool

Remarks

إذا قمت بتعيين ، يتم تقليد سلوك MS Word الذي يأخذ قيمة LCID من سجل Windows.

القيمة الافتراضية هي.

WarningCallback

يتم استدعاء أثناء عملية التحميل ، عندما يتم الكشف عن مشكلة قد تؤدي إلى فقدان البيانات أو صياغة الولاء.

public IWarningCallback WarningCallback { get; set; }

قيمة الممتلكات

IWarningCallback

Methods

Equals(الموضوع)

يحدد ما إذا كان الكائن المحدد يساوي في القيمة الكائن الحالي.

public override bool Equals(object obj)

Parameters

obj object

Returns

bool