עבודה עם הגדרות המסמך
עבודה עם הגדרות המסמך
מעבר לתוכן, מסמך Word נושא הגדרות ברמת היישום – מתגים של תאימות ישנה, העדפות היפנציה, תצורת המיזוג בדואר השמורה, אפשרויות תצוגה, ומצב הגנה מפני כתיבה. Aspose.Words FOSS עבור .NET חושף את אלה דרך ה Aspose.Words.Settings מרחב השמות וקבוצת תכונות על Document. דף זה מכסה כל קבוצת הגדרות ומה היא שולטת ומה אינה שולטת.
אפשרויות תאימות
Document.CompatibilityOptions הוא מופע של CompatibilityOptions המחזיק בעשרות מתגים בוליאניים המשחזרים התנהגויות עיצוב וריווח ספציפיות של Word ישן — לדוגמה GrowAutofit, UseWord2010TableStyleRules, UseWord2002TableStyleRules, AdjustLineHeightInTable, AlignTablesRowByRow, NoExtraLineSpacing, SuppressSpacingAtTopOfPage, SpacingInWholePoints, UseFELayout, ו-BalanceSingleByteDoubleByteWidth. הגדר את המאפיינים שאתה צריך ישירות כדי להתאים למאפייני הרינדור של גרסת Word ספציפית בכל כלי downstream הקורא את המסמך.
העדפות מקף
Document.HyphenationOptions הוא מופע של HyphenationOptions (AutoHyphenation, ConsecutiveHyphenLimit, HyphenateCaps, HyphenationZone) אשר מאחסן את העדפות המקף של Word עבור המסמך. מאפיינים אלה מעבירים את הבקשה הלוך וחזור; מכיוון שהגרסה הזו לא כוללת את מנוע פריסת העמודים, Aspose.Words FOSS אינו מחשב בעצמו את נקודות הפיצול של המקף — Word מחיל אותן בעת פתיחה ועימוד הקובץ.
תצורת מיזוג דואר
Document.MailMergeSettings הוא מופע MailMergeSettings המאחסן את תצורת המיזוג בדואר הרשומה במסמך: MainDocumentType, CheckErrors, Destination, DataSource, DataType, Query, ConnectString, MailSubject, MailAsAttachment, ActiveRecord, ו-ViewMergedData, בנוסף ל-Clear() ול-Clone(). עבור מקורות נתונים חיצוניים המחוברים באמצעות מנגנון Office Data Source Object של Word, MailMergeSettings.Odso חושף מופע Odso (DataSource, DataSourceType, TableName, ColumnDelimiter, FirstRowContainsColumnNames) ש-FieldMapDatas שלו (OdsoFieldMapDataCollection של OdsoFieldMapData: Name, MappedName, Column, Type) ו-RecipientDatas (OdsoRecipientDataCollection של OdsoRecipientData: Active, Column, Hash, UniqueTag) מתארים את מיפוי השדות ורשימת הנמענים.
הגדרות תצוגת מסמך
Document.ViewOptions הוא מופע ViewOptions השולט באופן שבו Word מציג את הקובץ כשפתחים אותו: ViewType, ZoomType, ZoomPercent, DisplayBackgroundShape, DoNotDisplayPageBoundaries, ו-FormsDesign. מאפיינים אלה משפיעים רק על תצוגת המסמך ב-Word עצמו – הם אינם משפיעים על האופן שבו Aspose.Words FOSS מעבד אותו.
הגנה מפני כתיבה
Document.WriteProtection הוא מופע WriteProtection (IsWriteProtected, ReadOnlyRecommended) עם SetPassword() להקמת סיסמת הגנה ו-ValidatePassword() לבדיקת סיסמה מועמדת כנגד אותה.
יחידות מדידה
ה-enum MeasurementUnits מציין את יחידת המדידה ש-Word צריך להשתמש בממשק שלו למסמך.
טיפים ושיטות עבודה מומלצות
CompatibilityOptions.OptimizeFor(MsWordVersion)קיים במחלקה אך המימוש שלו אינו שלם בבנייה זו – הוא זורקNotImplementedException. הגדר ישירות את תכונות הבוליאניותCompatibilityOptionsהאישיות שאתה צריך במקום להסתמך עלOptimizeForליישום פרופיל גרסה מלא בבת אחת.MailMergeSettingsandOdsoאחסן את המיזוג בדואר configuration שנרשמה במסמך – קריאה וכתיבה של תצורה זו נתמכת, אך ביצוע מיזוג דואר (מילוי שדות ממקור נתונים חי) אינו נכלל בגרסה הקוד-פתוחה הזו.HyphenationOptionsו-ViewOptionsהם שני העדפות תצוגה/ממשק משתמש ש-Word עצמו מיישם – אל תצפה שהקריאה ל-Document.Save()תשנה את האופן שבו הטקסט מתורגל או מופיע בהתבסס על ההגדרות האלו, מאחר שהגרסה הזו אינה כוללת את מנוע פריסת העמודים.- הקרא ל-
WriteProtection.SetPassword()לפני הפעלתIsWriteProtected, והשתמש ב-ValidatePassword()כדי לבדוק סיסמה מועמדת במקום לאחסן או להשוות את המחרוזת הגולמית בעצמך. CompatibilityOptions,HyphenationOptions,MailMergeSettings,ViewOptionsו-WriteProtectionנגישים ישירות מ-Document– אין צורך לחפש אותם בעץ הצמתים.
בעיות נפוצות
| בעיה | סיבה | תיקון |
|---|---|---|
CompatibilityOptions.OptimizeFor() משגר NotImplementedException | לא ממומש בבנייה זו | הגדר במקום זאת את תכונות הבוליאן האינדיבידואליות של CompatibilityOptions |
| Mail merge לא ממלא את המסמך בנתונים | MailMergeSettings רק שומרת את תצורת המיזוג; ביצוע אינו כלול במהדורה זו | קרא את תצורת מקור הנתונים השמורה והפעל את הלוגיקה שלך למילוי שדות, או השתמש ב-commercial Aspose.Words עבור .NET |
שינוי ViewOptions.ZoomPercent אינו משפיע בצורה נראית בעת עיבוד המסמך | ViewOptions משפיע רק על התצוגה ב-Word, ולא על העיבוד של Aspose.Words FOSS | התנהגות צפויה – אין צורך בתיקון |
WriteProtection.ValidatePassword() מחזיר false באופן בלתי צפוי | SetPassword() לא נקרא ראשון, או שהוגדרה סיסמה שונה | הפעל SetPassword() כדי לקבוע את הסיסמה המוגנת לפני האימות |
FAQ
האם אני יכול להשתמש ב-Aspose.Words FOSS כדי לבצע מיזוג דואר אמיתי?
לא. MailMergeSettings ו-Odso מאפשרים לך לקרוא ולכתוב את תצורת המיזוג שנשמרת במסמך, אך ביצוע מיזוג דואר – מילוי שדות ממקור נתונים – אינו נכלל במהדורה הקודפתוחה הזו.
האם CompatibilityOptions.OptimizeFor() עובד?
לא – זה זורק NotImplementedException בבנייה זו. במקום זאת, הגדר ישירות את תכונות CompatibilityOptions האישיות שאתה צריך.
איך אני מגן על מסמך באמצעות סיסמה מפני עריכות?
קרא ל-WriteProtection.SetPassword() על Document.WriteProtection, ואז הגדר את IsWriteProtected כדי להפעיל את ההגנה.
האם HyphenationOptions ו-ViewOptions משנים את האופן שבו המסמך מוצג?
לא. שניהם הן העדפות שמורות שמיקרוסופט וורד מיישמת כאשר הוא פותח ומציג את הקובץ. מהדורה זו אינה כוללת את מנוע הפריסה של העמוד, ולכן הגדרות אלו עובדות דרך מבלי שה-Aspose.Words FOSS עצמו מחשב את הפריסה מהן.
API Reference סיכום
| מחלקה / Enum | תיאור |
|---|---|
CompatibilityOptions | מתגי פריסת/ריווח בגרסאות Word הישנות, באמצעות Document.CompatibilityOptions |
Compatibility | Enum שמכנה את אפשרויות התאימות הבודדות |
MsWordVersion | ערכי גרסת Word שנעשה בהם שימוש על-ידי CompatibilityOptions.OptimizeFor() |
HyphenationOptions | העדפות היפנציה, באמצעות Document.HyphenationOptions |
MailMergeSettings | תצורת מיזוג דואר מאוחסנת, באמצעות Document.MailMergeSettings |
Odso | הגדרות חיבור של Office Data Source Object למיזוג דואר |
OdsoFieldMapData / OdsoFieldMapDataCollection | מיפוי עמודה-לשדה מיזוג עבור מקור נתונים של ODSO |
OdsoRecipientData / OdsoRecipientDataCollection | מצב הכללה/הוצאה לכל נמען במיזוג דואר |
ViewOptions | העדפות תצוגה של Word (תקריב, סמני עיצוב), דרך Document.ViewOptions |
WriteProtection | מצב הגנת כתיבה של המסמך, דרך Document.WriteProtection |
MeasurementUnits | יחידת המדידה ש-Word צריך להשתמש בממשק שלו |