RtfLoadOptions

RtfLoadOptions class

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

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

public class RtfLoadOptions : LoadOptions

المنشئون

اسموصف
RtfLoadOptions()تهيئة مثيل جديد لهذه الفئة بالقيم الافتراضية.

الخصائص

اسموصف
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; }يتم الاتصال به أثناء تحميل مستند ويقبل البيانات المتعلقة بتقدم التحميل.
RecognizeUtf8Text { get; set; }عند التعيين علىحقيقي ,CharsetDetector سيحاول اكتشاف أحرف UTF8، سيتم الاحتفاظ بها أثناء الاستيراد.
ResourceLoadingCallback { get; set; }يسمح بالتحكم في كيفية تحميل الموارد الخارجية (الصور، أوراق الأنماط) عند استيراد مستند من HTML، MHTML.
TempFolder { get; set; }يسمح باستخدام الملفات المؤقتة عند قراءة المستند. بشكل افتراضي هذه الخاصية هيباطل ولا يتم استخدام أي ملفات مؤقتة.
UpdateDirtyFields { get; set; }يحدد ما إذا كان سيتم تحديث الحقول ذات الامتداد أم لامتسخ السمة.
WarningCallback { get; set; }يتم استدعاؤه أثناء عملية التحميل، عند اكتشاف مشكلة قد تؤدي إلى فقدان دقة البيانات أو التنسيق.

طُرق

اسموصف
override Equals(object)

أمثلة

يوضح كيفية اكتشاف أحرف UTF-8 أثناء تحميل مستند RTF.

// قم بإنشاء كائن "RtfLoadOptions" لتعديل كيفية تحميل مستند RTF.
RtfLoadOptions loadOptions = new RtfLoadOptions();

// قم بتعيين خاصية "RecognizeUtf8Text" على "خطأ" لافتراض أن المستند يستخدم مجموعة أحرف ISO 8859-1
// ويقوم بتحميل كل حرف في المستند.
// قم بتعيين خاصية "RecognizeUtf8Text" على "true" لتحليل أي أحرف متغيرة الطول قد تظهر في النص.
loadOptions.RecognizeUtf8Text = recognizeUtf8Text;

Document doc = new Document(MyDir + "UTF-8 characters.rtf", loadOptions);

Assert.AreEqual(
    recognizeUtf8Text
        ? "“John Doe´s list of currency symbols”™\r" +
          "€, ¢, £, ¥, ¤"
        : "“John Doe´s list of currency symbolsâ€\u009dâ„¢\r" +
          "€, ¢, £, ¥, ¤",
    doc.FirstSection.Body.GetText().Trim());

أنظر أيضا