Field
Field class
يمثل حقل مستند Microsoft Word.
لمعرفة المزيد، قم بزيارةالعمل مع الحقول مقالة توثيقية.
public class Field
الخصائص
| اسم | وصف |
|---|---|
| DisplayResult { get; } | يحصل على النص الذي يمثل نتيجة الحقل المعروضة. |
| End { get; } | يحصل على العقدة التي تمثل نهاية الحقل. |
| Format { get; } | يحصل علىFieldFormatالكائن الذي يوفر الوصول المكتوب إلى تنسيق الحقل. |
| IsDirty { get; set; } | يحصل على أو يحدد ما إذا كانت النتيجة الحالية للحقل لم تعد صحيحة (قديمة) بسبب التعديلات الأخرى التي تم إجراؤها على المستند. |
| IsLocked { get; set; } | يحصل على أو يحدد ما إذا كان الحقل مقفلاً (لا ينبغي إعادة حساب نتيجته). |
| LocaleId { get; set; } | يحصل على أو يعين LCID للحقل. |
| Result { get; set; } | يحصل على النص الموجود بين فاصل الحقل ونهاية الحقل أو يعينه. |
| Separator { get; } | يحصل على العقدة التي تمثل فاصل الحقل. يمكن أن يكونباطل . |
| Start { get; } | يحصل على العقدة التي تمثل بداية الحقل. |
| virtual Type { get; } | يحصل على نوع حقل Microsoft Word. |
طُرق
| اسم | وصف |
|---|---|
| GetFieldCode() | يعيد النص بين بداية الحقل وفاصل الحقل (أو نهاية الحقل إذا لم يكن هناك فاصل). يتم تضمين كل من رمز الحقل ونتيجة الحقل للحقول الفرعية. |
| GetFieldCode(bool) | إرجاع النص بين بداية الحقل وفاصل الحقل (أو نهاية الحقل إذا لم يكن هناك فاصل). |
| Remove() | يُزيل الحقل من المستند. يُرجع عقدة بعد الحقل مباشرةً. إذا كانت نهاية الحقل هي آخر عقدة فرعية للعقدة الأصلية، تُرجع فقرته الأصلية. إذا كان الحقل قد حُذف مُسبقًا، تُرجعباطل . |
| Unlink() | يقوم بإلغاء ربط الحقل. |
| Update() | يُجري تحديث الحقل. يُطرح هذا الخطأ إذا كان الحقل قيد التحديث بالفعل. |
| Update(bool) | يُجري تحديثًا للحقل. يُطرح هذا الخطأ إذا كان الحقل قيد التحديث بالفعل. |
ملاحظات
الحقل في مستند وورد هو بنية معقدة تتكون من عدة عقد تتضمن بداية الحقل، ورمز الحقل، وفاصل الحقل، ونتيجة الحقل، ونهايته. يمكن أن تكون الحقول متداخلة، وتحتوي على محتوى غني، وتمتد إلى عدة فقرات أو أقسام في المستند.Field الفئة هي كائن “واجهة” يوفر خصائص وطرقًا تسمح بالعمل مع الحقل ككائن واحد.
الStart ،Separator وEnd تشير الخصائص إلى عقد البداية والفاصل والنهاية لحقل على التوالي.
المحتوى بين بداية الحقل والفاصل هو رمز الحقل. المحتوى بين فاصل الحقل ونهايته هو نتيجة الحقل. يتكون رمز الحقل عادةً من رمز واحد أو أكثر من .Run الكائنات التي تحدد التعليمات. من المتوقع أن يقوم تطبيق المعالجة بتنفيذ رمز الحقل لحساب نتيجة الحقل.
تُسمى عملية حساب نتائج الحقول “تحديث الحقل”. يُمكن لبرنامج Aspose.Words تحديث نتائج field لمعظم أنواع الحقول بنفس طريقة مايكروسوفت وورد. والجدير بالذكر أن Aspose.Words يستطيع حساب نتائج حتى حقول الصيغ الأكثر تعقيدًا. لحساب نتيجة field لحقل واحد، استخدمUpdate الطريقة. لتحديث الحقول في المستند بأكمله استخدمUpdateFields.
يمكنك الحصول على نسخة النص العادي من رمز الحقل باستخدامGetFieldCodeالطريقة. يمكنك الحصول على إصدار النص العادي لنتيجة الحقل وتعيينه باستخدامResult يمكن أن يحتوي كل من رمز الحقل ونتيجة الحقل على محتوى معقد، مثل الحقول المتداخلة والفقرات والأشكال والجداول، وفي هذه الحالة قد ترغب في العمل مع عقد الحقل بشكل مباشر إذا كنت بحاجة إلى مزيد من التحكم.
لا تقم بإنشاء حالات منField الفئة مباشرة. لإنشاء حقل جديد استخدمInsertField طريقة.
أمثلة
يوضح كيفية إدراج حقل في مستند باستخدام رمز الحقل.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Field field = builder.InsertField("DATE \\@ \"dddd, MMMM dd, yyyy\"");
Assert.AreEqual(FieldType.FieldDate, field.Type);
Assert.AreEqual("DATE \\@ \"dddd, MMMM dd, yyyy\"", field.GetFieldCode());
// يؤدي هذا التحميل الزائد لطريقة InsertField إلى تحديث الحقول المدرجة تلقائيًا.
Assert.True((DateTime.Today - DateTime.Parse(field.Result)).Days <= 1);
أنظر أيضا
- مساحة الاسم Aspose.Words.Fields
- المجسم Aspose.Words
