تنسيق نتيجة الحقل
تنسيق نتيجة الحقل
يوضح هذا الدليل كيفية التحكم في التنسيق الرقمي، وتنسيق التاريخ/الوقت، والتنسيق العام المطبق على النتيجة المحسوبة لحقل في Aspose.Words FOSS لـ .NET، باستخدام الفئة FieldFormat، والعدد GeneralFormat enum، وGeneralFormatCollection. كل مثال من Field يعرض مفاتيح التنسيق هذه عبر خاصية Format؛ هذه الصفحة هي الغوص العميق في ما تقدمه تلك الخاصية.
الوصول إلى تنسيق الحقل
كل Field — وفروعه المصنفة مثل FieldDate، FieldCreateDate، وFieldSymbol — يعرض خاصية Format من النوع FieldFormat، تُستخدم للوصول المصنّف إلى تنسيق الحقل الرقمي، وتنسيق التاريخ والوقت، والتنسيق العام. اقرأ Field.Format لتفحص أو تغير المفاتيح المرتبطة بشيفرة الحقل دون تعديل النص الخام يدوياً.
صور تنسيق الأرقام والتاريخ/الوقت
FieldFormat.NumericFormat هي خاصية string قابلة للكتابة تحتفظ بالتنسيق المطبق على نتيجة حقل رقمي. FieldFormat.DateTimeFormat هي خاصية string قابلة للكتابة تحتفظ بالتنسيق المطبق على نتيجة حقل تاريخ ووقت. اضبط أي من الخاصيتين لتغيير طريقة عرض القيمة المحسوبة لنوع الحقل المقابل.
التنسيقات العامة
FieldFormat.GeneralFormats يُعيد GeneralFormatCollection — تنسيقات عامة تُطبق على نتيجة عددية أو نصية أو أي حقل. أعضاؤه مأخوذة من تعداد GeneralFormat، الذي يضم تحولات الحالة (Upper، Lower، FirstCap، Caps)، الترقيم الروماني والترقيم الترتيبي (UppercaseRoman، LowercaseRoman، Ordinal، OrdText)، العملة والنص العددي (DollarText، BahtText، CardText)، أنظمة ترقيم خاصة بالمحلية (Aiueo، Arabic، ArabicAbjad، ArabicAlpha، ArabicDash، ChineseNum1–ChineseNum3، KanjiNum1–KanjiNum3، Hebrew1، Hebrew2، Ganada، Chosung، Zodiac1–Zodiac3، ThaiArabic، ThaiCardText، ThaiLetter، HindiArabic، HindiCardText، HindiLetter1، HindiLetter2، VietCardText، DBNum1–DBNum4، DBChar، SBChar، GB1–GB4، Hex، CircleNum، UppercaseAlphabetic، LowercaseAlphabetic)، والقيم الخاصة بدمج الحقول CharFormat، MergeFormat، وMergeFormatInet. None يمسح التنسيق العام.
إدارة GeneralFormatCollection
GeneralFormatCollection يطبق IEnumerable<GeneralFormat>، لذا يمكنك تكراره باستخدام GetEnumerator() في حلقة foreach. استدعِ Add(item) لإضافة قيمة GeneralFormat، وRemove(item) لإزالة كل حدوث للقيمة، أو RemoveAt(index) لإزالة القيمة في موضع محدد. Count يُبلغ عن عدد التنسيقات العامة المطبقة حالياً.
نصائح وأفضل الممارسات
- قم بتعيين
Field.Format.NumericFormatأوField.Format.DateTimeFormatبدلاً من دمج صورة تنسيق مباشرةً في سلسلة رمز الحقل — الخاصية المكتوبة تحافظ على تزامن رمز الحقل ومفتاح تنسيقه. - اجمع قيم
GeneralFormatمتعددة (مثلاًUpperوMergeFormat) بإضافة كل واحدة إلىGeneralFormatsعلى حدة؛ المجموعة تسمح بأكثر من إدخال واحد. - بعد تعديل أي خاصية من
FieldFormat، استدعِUpdate()على الحقل المالِك حتى ينعكس التنسيق الجديد فيResult/DisplayResult. - استخدم
GeneralFormat.Noneلمسح إدخال تنسيق عام صراحةً بدلاً من ترك قيم تنسيق قديمة في المجموعة. - تحقق من
GeneralFormatCollection.Countقبل الافتراض أن الحقل لا يحتوي على أي تنسيق عام مُطبق — مجموعة فارغة ومجموعة تحتوي علىNoneهما حالتان مختلفتان.
المشكلات الشائعة
| المشكلة | السبب | الإصلاح |
|---|---|---|
تغيير NumericFormat لا يُظهر أي تأثير | لم يتم إعادة حساب الحقل بعد التغيير | استدعِ Update() على الحقل بعد تعديل أي خاصية FieldFormat |
تظهر تنسيقات عامة مكررة في GeneralFormats | تم استدعاء Add(item) أكثر من مرة لنفس قيمة GeneralFormat | تحقق من GeneralFormatCollection.Count أو كرّر قبل الإضافة، أو استدعِ Remove(item) أولاً |
تم إزالة الإدخال الخاطئ من GeneralFormats | تم استدعاء RemoveAt(index) بمؤشر تغير بعد إزالة سابقة | تحقق من Count وكرّر المجموعة مرة أخرى قبل الإزالة حسب المؤشر |
FAQ
ما هو الغرض من FieldFormat؟
إنه كائن تنسيق مكتوب يُعرَض بواسطة Field.Format، ويمنح الوصول إلى تنسيق الأعداد للحقل (NumericFormat)، وتنسيق التاريخ/الوقت (DateTimeFormat)، والتنسيقات العامة (GeneralFormats).
هل يمكن أن يكون للحقل أكثر من تنسيق عام مُطبق؟
نعم — GeneralFormats هو GeneralFormatCollection، ويمكنك Add أكثر من قيمة GeneralFormat له.
كيف يمكنني إزالة جميع التنسيقات العامة من حقل؟
قم بتكرار GeneralFormats واستدعِ Remove(item) لكل قيمة، أو RemoveAt(index) لمدخل محدد.
هل يؤدي ضبط خصائص FieldFormat إلى تحديث النص المعروض للحقل تلقائيًا؟
لا — استدعِ Update() على الحقل بعد تغيير خصائص Format حتى يعكس Result وDisplayResult التنسيق الجديد.
API Reference ملخص
| فئة/طريقة | وصف |
|---|---|
FieldFormat | وصول مكتوب النوع إلى تنسيقات الحقل الرقمية، وتنسيق التاريخ/الوقت، والتنسيق العام؛ يُعرض عبر Field.Format |
FieldFormat.NumericFormat | صورة التنسيق المطبقة على نتيجة حقل رقمي |
FieldFormat.DateTimeFormat | صورة التنسيق المطبقة على نتيجة حقل تاريخ/وقت |
FieldFormat.GeneralFormats | GeneralFormatCollection من الصيغ العامة المطبقة على نتيجة الحقل |
GeneralFormat | تعداد لمفاتيح التنسيق العامة (تحويلات الحالة، أنظمة الترقيم، صيغ حقول الدمج) |
GeneralFormatCollection | مجموعة ذات نوع من قيم GeneralFormat؛ Add, Remove, RemoveAt, Count, GetEnumerator |
