تحديث الحقول

عادة ما يحتوي الحقل المدرج في Microsoft Word بالفعل على قيمة محدثة. على سبيل المثال، إذا كان الحقل عبارة عن صيغة أو رقم صفحة، فسيحتوي على القيمة المحسوبة الصحيحة للإصدار المحدد من المستند. ولكن إذا كان لديك تطبيق يقوم بإنشاء أو تعديل مستند بحقول مثل دمج مستندين أو ملئه بالبيانات، فيجب تحديث جميع الحقول بشكل مثالي حتى يكون المستند مفيدا.

كيفية تحديث الحقول

عند تحميل مستند، Aspose.Words يحاكي سلوك Microsoft Word مع خيار تحديث الحقول تلقائيا مغلقا. يمكن تلخيص السلوك على النحو التالي:

• عند فتح / حفظ مستند تظل الحقول سليمة
• يمكنك تحديث جميع الحقول في مستند بشكل صريح، على سبيل المثال، إعادة إنشاء TOC، عندما تحتاج إلى ذلك
• عند التقديم إلى PDF أو XPS يتم تحديث الحقول المتعلقة بترقيم الصفحات في الرؤوس/التذييلات
• عند تنفيذ Mail Merge يتم تحديث كافة الحقول تلقائيا

تحديث الحقول برمجيا

لتحديث الحقول بشكل صريح في المستند بأكمله، ما عليك سوى استدعاء طريقة UpdateFields. لتحديث الحقول الموجودة في جزء من مستند، احصل على كائن Range واستدعاء طريقة UpdateFields. في Aspose.Words، يمكنك الحصول على Range لأي عقدة في شجرة المستندات، مثل Section, HeaderFooter, Paragraph, الخ. باستخدام خاصية Node.Range.يمكنك تحديث نتيجة حقل واحد عن طريق استدعاء طريقة Update.

التحديث التلقائي للحقول المتعلقة بالصفحة أثناء العرض

عند تنفيذ تحويل مستند إلى تنسيق صفحة ثابتة على سبيل المثال إلى PDF أو XPS، سيقوم Aspose.Words تلقائيا بتحديث الحقول المتعلقة بتخطيط الصفحة PAGE، PAGEREF الموجودة في رؤوس/تذييلات المستند. يحاكي هذا السلوك سلوك Microsoft Word عند طباعة مستند.

إذا كنت تريد تحديث جميع الحقول الأخرى في المستند، فأنت بحاجة إلى الاتصال UpdateFields قبل تقديم المستند.

يوضح مثال التعليمات البرمجية التالية كيفية تحديث كافة الحقول قبل تقديم مستند:

تحديث الحقل التلقائي خلال Mail Merge

عند تنفيذ mail merge، سيتم تحديث جميع الحقول في المستند تلقائيا. هذا لأن Mail Merge هي حالة تحديث ميداني. يواجه البرنامج حقلا Mail Merge ويحتاج إلى تحديث نتيجته، والتي تتضمن الحصول على القيمة من مصدر البيانات وإدخالها في الحقل. المنطق هو بالطبع أكثر تعقيدا، على سبيل المثال، عندما يتم الوصول إلى نهاية الوثيقة/mail merge المنطقة ولكن لا يزال هناك المزيد من البيانات ليتم دمجها، ثم المنطقة تحتاج إلى تكرار ومجموعة جديدة من الحقول المحدثة.

تحديث LastSavedTime الممتلكات قبل الحفظ

يمكنك استخدام خاصية UpdateLastSavedTimeProperty سواء لتحديث خاصية المستند المضمنة المقابلة LastSavedTime عند حفظ المستند.

يوضح مثال التعليمات البرمجية التالية كيفية تحديث هذه الخاصية: