עדכון שדות
בדרך כלל, שדה מוכנס לתוך Microsoft Word כבר מכיל ערך עדכני. לדוגמה, אם השדה הוא נוסחה או מספר דף, הוא יכיל את הערך הרצוי הנכון לגרסה נתונה של המסמך. אבל אם יש לך יישום אשר יוצר או משנה מסמך עם שדות כמו מיזוג שני מסמכים או המאוכלס אותו עם נתונים, אז באופן אידיאלי כל התחומים חייבים להיות מעודכנים עבור המסמך להיות שימושי.
כיצד לעדכן שדות
כאשר מסמך טעון, Aspose.Words לחקות את ההתנהגות של Microsoft Word עם האפשרות לעדכן באופן אוטומטי שדות מוחלפו. ניתן לסכם את ההתנהגות כדלקמן:
- כאשר אתה פותח / שומר מסמך שהשדות נשארים שלמים
- אתה יכול לעדכן במפורש את כל התחומים במסמך (למשל לבנות מחדש את TOC) כאשר אתה צריך
- בעת הדפסה / חזרה ל- PDF או XPS השדות הקשורים למספר העמודים ב Headers/footers מעודכנים
- כאשר אתה מבצע Mail Merge כל התחומים מעודכנים באופן אוטומטי
עדכון שדות
כדי לעדכן במפורש שדות במסמך כולו, פשוט לקרוא update_fields. כדי לעדכן שדות הכלולים במסגרת מסמך, קבל Range להתנגד ולקרוא update_fields שיטה. In In In Aspose.Words, אתה יכול להשיג Range עבור כל צומת בעץ המסמך, כגון Section, HeaderFooter, Paragraph, וכו' באמצעות Node.range רכוש. אתה יכול לעדכן את התוצאה של שדה אחד על ידי קריאה update שיטה.
עדכון אוטומטי של Page-Related Fields במהלך Rendering
כאשר אתה מבצע המרה של מסמך לפורמט קבוע של דף לדוגמה ל- PDF או PDF או XPS, ואז Aspose.Words באופן אוטומטי לעדכן את שדות הקשורים ל-Page פריסה PAGE, PAGEREF נמצא בראש/עמודי המסמך. התנהגות זו מחקה את ההתנהגות של Microsoft Word בעת הדפסה של מסמך.
אם אתה רוצה לעדכן את כל השדות האחרים במסמך, עליך להתקשר update_fields לפני הגשת המסמך.
הדוגמה הבאה של הקוד מראה כיצד לעדכן את כל התחומים לפני ביצוע מסמך:
עדכון שדה אוטומטי במהלך Mail Merge
כשאתם מבצעים mail merge" כל התחומים במסמך מעודכנים באופן אוטומטי. הסיבה לכך היא Mail Merge זה מקרה של עדכון שדה. התוכנית פוגשת Mail Merge שדה וצריכה לעדכן את התוצאה שלה, אשר כרוך לתפוס את הערך ממקור הנתונים ולהכניס אותו לתחום. ההיגיון הוא כמובן מורכב יותר, למשל, כאשר סוף המסמך /mail merge האזור מגיע אבל יש עדיין נתונים נוספים להתמזג, אז האזור צריך להיות משוכפל ואת מערכת שדות חדשה מעודכן.
עקבו אחרי Dirty Attribute
Wdirty הוא תכונה ברמה שדה כי יהיה לרענן רק את השדה שאתה מציין כאשר המסמך נפתח. זה אומר ל-MS Word רק לרענן שדה זה בפעם הבאה שהמסמכים נפתחים. אתה יכול להשתמש update_dirty_fields רכוש כדי לציין אם לעדכן את התחומים עם התכונה המלוכלכת. כאשר הערך של תגית: Dirty_fields מוגדר True" לכל התחומים יש True ערך Field.is_dirty או FieldChar.is_dirty נכסים מעודכנים על עומס המסמכים.
הדוגמה הבאה של הקוד מראה כיצד לעדכן שדות שיש להם את התכונה המלוכלכת:
עדכון אחרון הנכס לפני החיסכון
אתה יכול להשתמש SaveOptions.update_last_saved_time_property רכוש אם לעדכן את הנכס המובנה המתאים last_saved_time בעת שמירת המסמך.
דוגמה לקוד הבא מראה כיצד לעדכן את הנכס: