כיצד לעבוד עם מאפייני מסמך ב-.NET

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

Document.BuiltInDocumentProperties מחזיר אוסף של BuiltInDocumentProperties. מכיוון שמדובר במערך קבוע וידוע של מאפיינים, הערכים נקראים ונכתבים כחברים רגילים במקום לחפש אותם לפי שם — לדוגמה BuiltInDocumentProperties.Author, .Title, .Subject, .Manager, .Company, .Category, .Keywords ו-.Comments עבור שדות תיאוריים, או .CreatedTime, .LastSavedTime, .LastPrinted ו-.LastSavedBy עבור חותמות זמן. סטטיסטיקות כגון .Characters, .CharactersWithSpaces, .Lines ו-.Bytes נחשפות גם הן באופן זה, לצד .Template ו-.HyperlinkBase.

שלב 2: הוספת מאפיין מסמך מותאם אישית

Document.CustomDocumentProperties מחזיר CustomDocumentProperties של אוסף עבור מטא-נתונים המוגדרים על ידי היישום שאינם חלק מהמכלול המובנה של Word. קרא לאחת מהגרסאות העומס של Add(name, value) עם שם וערך טיפוסי — מחרוזת, מספר, בוליאני, או תאריך, בהתאם לאיזה תעמוס תואם לסוג הערך — כדי ליצור מאפיין חדש.

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

במקום ערך סטטי, מאפיין מותאם יכול לעקוב אחרי טווח תוכן מסומן בסימנייה כך שערכו נשאר מסונכרן עם אותו תוכן. קרא ל-CustomDocumentProperties.AddLinkToContent(name, linkSource), תוך העברת שם הסימנייה כ-linkSource, במקום לסנכרן ידנית מאפיין סטטי בכל פעם שהתוכן המקושר משתנה.

שלב 4: חיפוש, בדיקה והסרת מאפיינים

BuiltInDocumentProperties ו-CustomDocumentProperties נגזרים מהמחלקה האבסטרקטית DocumentPropertyCollection, ולכן נבדקים באותו האופן: גישה לפי שם (למשל properties[name]) מחזירה מאפיין, Contains(name) בודקת אם הוא קיים, IndexOf(name) מחזירה את המיקום שלו, ו-Count מדווחת כמה מאפיינים האוסף מכיל. קרא ל-Contains(name) לפני גישה לפי שם כאשר ייתכן שמאפיין מותאם אינו קיים, כדי להימנע מטיפול במאפיין חסר כנתיב חריגה. הסר מאפיין באמצעות Remove(name) או RemoveAt(index), או נקה את כל המאפיינים באוסף באמצעות Clear().

שלב 5: קריאת ערך של מאפיין מותאם ללא ידיעת סוגו מראש

DocumentProperty מכיל Name, Value ללא טיפוס, ו-Type — ערך enum של PropertyType: Boolean, DateTime, Double, Number, String, StringArray, ObjectArray, ByteArray או Other. מכיוון ש-Value אינו טיפוסי, השתמש במגיש המתאים עם טיפוס במקום לבצע המרה ישירה: ToInt(), ToDouble(), ToDateTime(), ToBool(), ToByteArray() או ToString(). בדוק את IsLinkToContent ו-LinkSource כדי לגלות האם מאפיין מקושר לתוכן המסמך (ראה שלב 3) במקום להחזיק ערך סטטי.

שלב 6: בדיקת מצב ההגנה של המסמך

BuiltInDocumentProperties.Security מדווח על ערך DocumentSecurity המתאר את המטא-נתונים של ההגנה המאוחסנת במסמך: None, PasswordProtected, ReadOnlyRecommended, ReadOnlyEnforced או ReadOnlyExceptAnnotations. קרא מאפיין זה לפני שתחליט אם נדרש עיבוד נוסף הקשור להגנה על מסמך טעון.