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() يزيل الحقل من المستند. إرجاع عقدة بعد الحقل مباشرة. إذا كانت نهاية الحقل هي آخر child من العقدة الأصلية ، يتم إرجاع فقرته الأصلية. إذا تمت إزالة الحقل بالفعل ، يعود لا شيء .
Unlink() يقوم بإلغاء ربط الحقل.
Update() يقوم بالتحديث الميداني. يرمي إذا تم تحديث الحقل بالفعل.
Update(bool) يقوم بإجراء تحديث ميداني. يرمي إذا تم تحديث الحقل بالفعل.

ملاحظات

إن الحقل في مستند Word عبارة عن بنية معقدة تتكون من عقد متعددة تتضمن بداية الحقل ، وكود الحقل ، وفاصل الحقل ، ونتيجة الحقل ونهاية الحقل. يمكن أن تكون الحقول متداخلة ، وتحتوي على محتوى غني وامتداد عدة فقرات أو أقسام في المستند. الFieldالفئة هي كائن “واجهة” يوفر خصائص وطرق تسمح بالعمل مع حقل ككائن واحد.

الStart وSeparator وEnd تشير الخصائص إلى بداية الحقل والفاصل ونهاية الحقل على التوالي.

المحتوى بين بداية الحقل والفاصل هو رمز الحقل. المحتوى بين فاصل الحقل ونهاية الحقل هو نتيجة الحقل. يتكون رمز الحقل عادةً من واحد أو أكثر Run الكائنات التي تحدد التعليمات. من المتوقع أن يقوم تطبيق المعالجة بتنفيذ كود الحقل لحساب نتيجة الحقل.

تسمى عملية حساب النتائج الميدانية التحديث الميداني. يمكن لـ Aspose.Words تحديث نتائج field لمعظم أنواع الحقول بنفس الطريقة تمامًا التي يقوم بها Microsoft Word. والأهم من ذلك ، Aspose. يمكن للكلمات حساب نتائج حتى أكثر حقول الصيغة تعقيدًا. لحساب نتيجة field لحقل واحد ، استخدم ملفUpdate طريقة. لتحديث الحقول في document بالكامل استخدمUpdateFields.

يمكنك الحصول على إصدار النص العادي لرمز الحقل باستخدام امتدادGetFieldCode method. يمكنك الحصول على إصدار النص العادي لنتيجة الحقل وتعيينه باستخدام ملحقResult property. يمكن أن يحتوي كل من رمز الحقل ونتيجة الحقل على محتوى معقد ، مثل الحقول المتداخلة والفقرات والأشكال والجداول وفي هذه الحالة قد ترغب في العمل مع عقد الحقول مباشرةً إذا كنت بحاجة إلى مزيد من التحكم.

لا تقوم بإنشاء مثيلات منField class مباشرة. لإنشاء حقل جديد استخدم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.That(DateTime.Parse(field.Result), Is.EqualTo(DateTime.Today).Within(1).Days);

أنظر أيضا