FieldOptions

FieldOptions class

يمثل خيارات للتحكم في التعامل مع الحقول في المستند.

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

public sealed class FieldOptions

الخصائص

اسموصف
BarcodeGenerator { get; set; }يحصل على مولد الباركود المخصص أو يعينه.
BibliographyStylesProvider { get; set; }يحصل على أو يعين موفرًا يعيد نمط ببليوغرافيا لـ FieldBibliography وFieldCitation الحقول.
BuiltInTemplatesPaths { get; set; }يحصل على مسارات قوالب MS Word المضمنة أو يعينها.
ComparisonExpressionEvaluator { get; set; }يحصل على أو يعين مُقيِّم تعبيرات مقارنة الحقل.
CurrentUser { get; set; }يحصل على معلومات المستخدم الحالية أو يعينها.
CustomTocStyleSeparator { get; set; }يحصل على أو يعين فاصل النمط المخصص لمفتاح \t فيFieldToc الحقل.
DefaultDocumentAuthor { get; set; }يحصل على اسم مؤلف المستند الافتراضي أو يعيّنه. إذا كان اسم المؤلف محددًا مسبقًا في خصائص المستند المضمنة، فلن يُؤخذ هذا الخيار في الاعتبار.
FieldDatabaseProvider { get; set; }يحصل على أو يعين موفرًا يعيد نتيجة استعلام لـFieldDatabase الحقل.
FieldIndexFormat { get; set; }يحصل على أو يعينFieldIndexFormat الذي يمثل التنسيق لـFieldIndex الحقول في المستند.
FieldUpdateCultureProvider { get; set; }يحصل على أو يعين موفرًا يعيد كائن ثقافة محددًا لكل حقل معين.
FieldUpdateCultureSource { get; set; }يحدد الثقافة التي سيتم استخدامها لتنسيق نتيجة الحقل.
FieldUpdatingCallback { get; set; }يحصل أو يعينIFieldUpdatingCallback التنفيذ
FieldUpdatingProgressCallback { get; set; }يحصل أو يعينIFieldUpdatingProgressCallback التنفيذ.
FileName { get; set; }يحصل على اسم ملف المستند أو يعينه.
IsBidiTextSupportedOnUpdate { get; set; }يحصل على القيمة التي تشير إلى ما إذا كان النص ثنائي الاتجاه مدعومًا بالكامل أثناء تحديث الحقل أم لا أو يعينها.
LegacyNumberFormat { get; set; }يحصل على القيمة التي تشير إلى ما إذا كان تنسيق الأرقام القديم (الأقدم من AW 13.10) للحقول ممكّنًا أم لا أو يعينها.
PreProcessCulture { get; set; }يحصل على الثقافة أو يعينها لمعالجة قيم الحقول مسبقًا.
ResultFormatter { get; set; }يسمح بالتحكم في كيفية تنسيق نتيجة الحقل.
TemplateName { get; set; }يحصل على اسم ملف القالب الذي يستخدمه المستند أو يعينه.
ToaCategories { get; set; }يحصل على فئات جدول السلطات أو يعينها.
UseInvariantCultureNumberFormat { get; set; }يحصل على القيمة أو يعينها للإشارة إلى أن تنسيق الرقم يتم تحليله باستخدام ثقافة ثابتة أم لا
UserPromptRespondent { get; set; }يحصل على المستجيب أو يعينه على مطالبات المستخدم أثناء تحديث الحقل.

أمثلة

يوضح كيفية تحديد مصدر الثقافة المستخدمة لتنسيق التاريخ أثناء تحديث الحقل أو دمج البريد.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// أدخل حقلي دمج باللغة الألمانية.
builder.Font.LocaleId = new CultureInfo("de-DE").LCID;
builder.InsertField("MERGEFIELD Date1 \\@ \"dddd, d MMMM yyyy\"");
builder.Write(" - ");
builder.InsertField("MERGEFIELD Date2 \\@ \"dddd, d MMMM yyyy\"");

// قم بتعيين الثقافة الحالية إلى اللغة الإنجليزية الأمريكية بعد الحفاظ على قيمتها الأصلية في المتغير.
CultureInfo currentCulture = Thread.CurrentThread.CurrentCulture;
Thread.CurrentThread.CurrentCulture = new CultureInfo("en-US");

// سيستخدم هذا الدمج ثقافة الموضوع الحالي لتنسيق التاريخ، باللغة الإنجليزية الأمريكية.
doc.MailMerge.Execute(new[] { "Date1" }, new object[] { new DateTime(2020, 1, 01) });

// قم بتكوين الدمج التالي للحصول على قيمة ثقافته من رمز الحقل. ستكون قيمة هذه الثقافة بالألمانية.
doc.FieldOptions.FieldUpdateCultureSource = FieldUpdateCultureSource.FieldCode;
doc.MailMerge.Execute(new[] { "Date2" }, new object[] { new DateTime(2020, 1, 01) });

// تحتوي نتيجة الدمج الأولى على تاريخ بتنسيق اللغة الإنجليزية، بينما النتيجة الثانية باللغة الألمانية.
Assert.AreEqual("Wednesday, 1 January 2020 - Mittwoch, 1 Januar 2020", doc.Range.Text.Trim());

//استعادة ثقافة الموضوع الأصلية.
Thread.CurrentThread.CurrentCulture = currentCulture;

أنظر أيضا