עדכון שדות

בדרך כלל, שדה מוכנס לתוך Microsoft Word כבר מכיל ערך עדכני. לדוגמה, אם השדה הוא נוסחה או מספר דף, הוא יכיל את הערך הרצוי הנכון לגרסה נתונה של המסמך. אבל אם יש לך יישום אשר יוצר או משנה מסמך עם שדות כמו מיזוג שני מסמכים או המאוכלס אותו עם נתונים, אז באופן אידיאלי כל התחומים חייבים להיות מעודכנים עבור המסמך להיות שימושי.

כיצד לעדכן שדות

כאשר מסמך טעון, Aspose.Words לחקות את ההתנהגות של Microsoft Word עם האפשרות לעדכן באופן אוטומטי שדות מוחלפו. ניתן לסכם את ההתנהגות כדלקמן:

  • כאשר אתה פותח / שומר מסמך שהשדות נשארים שלמים
  • אתה יכול לעדכן במפורש את כל התחומים במסמך, למשל, לבנות מחדש TOC, כאשר אתה צריך
  • בעת הדפסה / חזרה ל- PDF או XPS השדות הקשורים למספר העמודים ב Headers/footers מעודכנים
  • כאשר אתה מבצע mail merge כל התחומים מעודכנים באופן אוטומטי

עדכון שדות

כדי לעדכן באופן מפורש שדות בכל המסמך, פשוט לקרוא UpdateFields שיטה. כדי לעדכן שדות הכלולים במסגרת מסמך, קבל Range להתנגד ולקרוא UpdateFields שיטה. In In In Aspose.Words, אתה יכול להשיג Range עבור כל צומת בעץ המסמך, כגון Section, HeaderFooter , Paragraph, וכו' באמצעות Node.Range רכוש. אתה יכול לעדכן את התוצאה של שדה אחד על ידי קריאה Update שיטה.

כאשר אתה מבצע המרה של מסמך לפורמט קבוע של דף לדוגמה ל- PDF או PDF או XPS, ואז Aspose.Words באופן אוטומטי לעדכן את שדות הקשורים ל-Page פריסה PAGE, PAGEREF נמצא בראש/עמודי המסמך. התנהגות זו מחקה את ההתנהגות של Microsoft Word בעת הדפסה של מסמך.

אם אתה רוצה לעדכן את כל השדות האחרים במסמך, עליך להתקשר UpdateFields לפני הגשת המסמך.

הדוגמה הבאה של הקוד מראה כיצד לעדכן את כל התחומים לפני ביצוע מסמך:

עדכון שדה אוטומטי במהלך Mail Merge

כשאתם מבצעים <span notrans="<span notrans=" mail merge"="">" כל התחומים במסמך מעודכנים באופן אוטומטי. הסיבה לכך היא mail merge זה מקרה של עדכון שדה. התוכנית פוגשת mail merge שדה וצריכה לעדכן את התוצאה שלה, אשר כרוך לתפוס את הערך ממקור הנתונים ולהכניס אותו לתחום. ההיגיון הוא כמובן מורכב יותר, למשל, כאשר סוף המסמך /mail merge האזור מגיע אבל יש עדיין נתונים נוספים להתמזג, אז האזור צריך להיות משוכפל ואת מערכת שדות חדשה מעודכן.

עקבו אחרי Dirty Attribute

Wdirty הוא תכונה ברמה שדה כי יהיה לרענן רק את השדה שאתה מציין כאשר המסמך נפתח. זה אומר ל-MS Word רק לרענן שדה זה בפעם הבאה שהמסמכים נפתחים. אתה יכול להשתמש UpdateDirtyFields רכוש כדי לציין אם לעדכן את התחומים עם התכונה המלוכלכת. כאשר הערך של UpdateDirtyFields מוגדר <span notrans="<span notrans=" true"="">" לכל התחומים יש true ערך Field.IsDirty או FieldChar.IsDirty נכסים מעודכנים על עומס המסמכים.

הדוגמה הבאה של הקוד מראה כיצד לעדכן שדות שיש להם את התכונה המלוכלכת:

עדכון אחרון הנכס לפני החיסכון

אתה יכול להשתמש UpdateLastSavedTimeProperty רכוש אם לעדכן את הנכס המובנה המתאים LastSavedTime בעת שמירת המסמך.

דוגמה לקוד הבא מראה כיצד לעדכן את הנכס: