עבודה עם מאפייני מסמך

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

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

כדאי לדעת שמידע על API ומספר הגרסה נכתב ישירות למסמכי פלט. לדוגמה, לאחר המרת מסמך ל - PDF, Aspose.Words ממלא את שדה “יישום” עם “Aspose.Words”, ואת שדה “PDF מפיק” עם “Aspose.Words עבור C++ YY.מ. נ”, שבו YY.M.N היא הגרסה של Aspose.Words המשמשת להמרה. לפרטים נוספים, ראה גנרטור או שם יצרן כלול במסמכי פלט.

גישה למאפייני מסמך

כדי לגשת למאפייני מסמך ב Aspose.Words השתמש:

BuiltInDocumentProperties

BuiltInDocumentProperties

המחלקה DocumentProperty מאפשרת לך לקבל את השם, הערך והסוג של מאפיין מסמך. Value מחזיר אובייקט, אך יש קבוצה של שיטות המאפשרות לך להמיר את ערך המאפיין לסוג מסוים. לאחר שתכיר איזה סוג המאפיין, תוכל להשתמש באחת מהשיטות DocumentProperty.ToXXX, כגון DocumentProperty.ToString ו DocumentProperty.ToInt, כדי לקבל את הערך של הסוג המתאים.

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

ב Microsoft Word, אתה יכול לגשת למאפייני מסמך באמצעות התפריט" קובץ מאפיינים".

work-with-document-properties-aspose-words-cpp_1.png

הוספה או הסרה של מאפייני מסמך

לא ניתן להוסיף או להסיר מאפייני מסמך מובנים באמצעות Aspose.Words. אתה יכול רק לשנות או לעדכן את הערכים שלהם.

כדי להוסיף מאפייני מסמך מותאמים אישית עם Aspose.Words, השתמש בשיטת Add, והעביר את שם המאפיין החדש ואת הערך של הסוג המתאים. השיטה מחזירה את האובייקט החדש שנוצר DocumentProperty.

כדי להסיר מאפיינים מותאמים אישית, השתמש בשיטת Remove, העבר לה את שם המאפיין להסרה, או בשיטת RemoveAt להסרת המאפיין לפי אינדקס. ניתן גם להסיר את כל המאפיינים בשיטת Clear.

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

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

עדכון מאפייני מסמך מובנים

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

צור נכס מותאם אישית חדש המקושר לתוכן

Aspose.Words מספק את השיטה AddLinkToContent ליצירת מאפיין מסמך מותאם אישית חדש המקושר לתוכן. מאפיין זה מחזיר את אובייקט המאפיין החדש שנוצר או את האפס אם LinkSource אינו חוקי.

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

קבל משתני מסמך

אתה יכול לקבל אוסף של משתני מסמך באמצעות המאפיין Variables. שמות וערכים משתנים הם מחרוזות.

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

הסר מידע אישי מהמסמך

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

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

המר בין יחידות מדידה ב C++