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) | إجراء تحديث ميداني. يتم الرمي إذا تم تحديث الحقل بالفعل. |
ملاحظات
الحقل في مستند Word عبارة عن بنية معقدة تتكون من عقد متعددة تتضمن بداية الحقل ورمز الحقل وفاصل الحقل ونتيجة الحقل ونهاية الحقل. يمكن أن تكون الحقول متداخلة، وتحتوي على محتوى غني وتمتد إلى فقرات أو أقسام متعددة في المستند. الField الفئة هي كائن “واجهة” يوفر خصائص وأساليب تسمح بالعمل مع الحقل ككائن واحد.
الStart ,Separator وEnd تشير الخصائص إلى بداية الحقل والعقد الفاصلة والنهاية للحقل على التوالي.
المحتوى بين بداية الحقل والفاصل هو رمز الحقل. المحتوى بين فاصل الحقل ونهاية الحقل هو نتيجة الحقل. يتكون رمز الحقل عادةً من واحد أو أكثر Run الكائنات التي تحدد التعليمات. من المتوقع أن يقوم تطبيق المعالجة بتنفيذ رمز الحقل لحساب نتيجة الحقل.
تسمى عملية حساب النتائج الميدانية بالتحديث الميداني. يمكن لـ Aspose.Words تحديث نتائج field لمعظم أنواع الحقول بنفس الطريقة التي يقوم بها Microsoft Word. وأبرزها، Aspose.Words يمكنه حساب نتائج حتى حقول الصيغة الأكثر تعقيدًا. لحساب نتيجة field لحقل واحد استخدمUpdate طريقة. لتحديث الحقول في استخدام document بأكملهUpdateFields.
يمكنك الحصول على نسخة النص العادي من رمز الحقل باستخدامGetFieldCode الطريقة. يمكنك الحصول على إصدار النص العادي لنتيجة الحقل وتعيينه باستخدام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);
أنظر أيضا
- مساحة الاسم Aspose.Words.Fields
- المجسم Aspose.Words
