HtmlLoadOptions

HtmlLoadOptions class

يسمح بتحديد خيارات إضافية عند تحميل مستند HTML فيDocument الكائن.

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

public class HtmlLoadOptions : LoadOptions

المنشئون

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

الخصائص

اسموصف
BaseUri { get; set; }يحصل على السلسلة التي سيتم استخدامها لتحويل عناوين URI النسبية الموجودة في المستند إلى عناوين URI مطلقة عند الحاجة إليها أو يعينها. يمكن أن يكونباطل أو سلسلة فارغة. الافتراضي هوباطل .
BlockImportMode { get; set; }يحصل على قيمة تحدد كيفية استيراد خصائص عناصر مستوى الكتلة أو يعينها. القيمة الافتراضية هيMerge .
ConvertMetafilesToPng { get; set; }يحصل على أو يحدد ما إذا كان سيتم تحويل الملف التعريفي (Wmf أوEmf ) الصور إلىPngتنسيق الصورة.
ConvertShapeToOfficeMath { get; set; }يحصل على أو يحدد ما إذا كان سيتم تحويل الأشكال باستخدام EquationXML إلى كائنات Office Math.
ConvertSvgToEmf { get; set; }يحصل على قيمة أو يعينها للإشارة إلى ما إذا كان سيتم تحويل صور SVG المحملة إلى تنسيق EMF. القيمة الافتراضية هيخطأ شنيع وإذا كان ذلك ممكنًا، يتم تخزين صور SVG المحملة كما هي دون تحويل.
Encoding { get; set; }يحصل على أو يعين الترميز الذي سيتم استخدامه لتحميل مستند HTML أو TXT أو CHM إذا لم يتم تحديد الترميز داخل المستند. يمكن أن يكونباطل . الافتراضي هوباطل .
FontSettings { get; set; }يسمح بتحديد إعدادات خط المستند.
IgnoreNoscriptElements { get; set; }يحصل على قيمة أو يعينها للإشارة إلى ما إذا كان سيتم تجاهل عناصر HTML <noscript>. القيمة الافتراضية هيخطأ شنيع .
IgnoreOleData { get; set; }يحدد ما إذا كان سيتم تجاهل بيانات OLE.
LanguagePreferences { get; }يحصل على تفضيلات اللغة التي سيتم استخدامها عند تحميل المستند.
LoadFormat { get; set; }يحدد تنسيق المستند الذي سيتم تحميله. الافتراضي هوAuto .
MswVersion { get; set; }يسمح بتحديد أن عملية تحميل المستند يجب أن تتطابق مع إصدار MS Word محدد. القيمة الافتراضية هيWord2019
Password { get; set; }يحصل على كلمة المرور لفتح مستند مشفر أو يعينها. يمكن أن يكونباطل أو سلسلة فارغة. الافتراضي هوباطل .
PreferredControlType { get; set; }يحصل على أو يعين النوع المفضل من عقد المستندات التي ستمثل عناصر <input> و<select> المستوردة. القيمة الافتراضية هيFormField .
PreserveIncludePictureField { get; set; }يحصل على أو يعين ما إذا كان سيتم الاحتفاظ بحقل INCLUDEPICTURE عند قراءة تنسيقات Microsoft Word. القيمة الافتراضية هيخطأ شنيع .
ProgressCallback { get; set; }يتم استدعاؤها أثناء تحميل مستند وتقبل البيانات حول تقدم التحميل.
ResourceLoadingCallback { get; set; }يسمح بالتحكم في كيفية تحميل الموارد الخارجية (الصور، أوراق الأنماط) عند استيراد مستند من HTML، MHTML.
SupportFontFaceRules { get; set; }يحصل على قيمة أو يعينها للإشارة إلى ما إذا كان سيتم دعم قواعد @font-face وما إذا كان سيتم تحميل الخطوط المعلنة. القيمة الافتراضية هيخطأ شنيع .
SupportVml { get; set; }يحصل على قيمة تشير إلى ما إذا كان سيتم دعم صور VML أم لا أو تعيينها.
TempFolder { get; set; }يسمح باستخدام الملفات المؤقتة عند قراءة المستند. بشكل افتراضي، هذه الخاصية هيباطل ولا يتم استخدام أي ملفات مؤقتة.
UpdateDirtyFields { get; set; }يحدد ما إذا كان سيتم تحديث الحقول باستخداممتسخ السمة.
UseSystemLcid { get; set; }يحصل على أو يحدد ما إذا كان سيتم استخدام قيمة LCID التي تم الحصول عليها من سجل Windows لتحديد هوامش إعداد الصفحة الافتراضية.
WarningCallback { get; set; }يتم استدعاؤها أثناء عملية التحميل، عند اكتشاف مشكلة قد تؤدي إلى فقدان دقة البيانات أو التنسيق.
WebRequestTimeout { get; set; }عدد الملي ثانية التي يجب انتظارها قبل انتهاء مهلة طلب الويب. القيمة الافتراضية هي ١٠٠٠٠٠ ميلي ثانية (١٠٠ ثانية).

طُرق

اسموصف
override Equals(object)يحدد ما إذا كان الكائن المحدد يساوي في القيمة الكائن الحالي.

أمثلة

يوضح كيفية دعم التعليقات الشرطية أثناء تحميل مستند HTML.

HtmlLoadOptions loadOptions = new HtmlLoadOptions();

// إذا كانت القيمة صحيحة، فإننا نأخذ كود VML في الاعتبار أثناء تحليل المستند المحمّل.
loadOptions.SupportVml = supportVml;

// تحتوي هذه الوثيقة على صورة JPEG ضمن علامات "<!--[if gte vml 1]>"،
// وصورة PNG مختلفة ضمن علامات "<![if !vml]>".
// إذا قمنا بتعيين علامة "SupportVml" إلى "true"، فسوف يقوم Aspose.Words بتحميل ملف JPEG.
// إذا قمنا بتعيين هذا العلم إلى "false"، فسوف يقوم Aspose.Words بتحميل PNG فقط.
Document doc = new Document(MyDir + "VML conditional.htm", loadOptions);

if (supportVml)
    Assert.AreEqual(ImageType.Jpeg, ((Shape)doc.GetChild(NodeType.Shape, 0, true)).ImageData.ImageType);
else
    Assert.AreEqual(ImageType.Png, ((Shape)doc.GetChild(NodeType.Shape, 0, true)).ImageData.ImageType);

أنظر أيضا