עבודה עם הגדרות המסמך

עבודה עם הגדרות המסמך

עבודה עם הגדרות המסמך

מעבר לתוכן, מסמך 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 ליישום פרופיל גרסה מלא בבת אחת.
  • MailMergeSettings and Odso אחסן את המיזוג בדואר 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
CompatibilityEnum שמכנה את אפשרויות התאימות הבודדות
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 צריך להשתמש בממשק שלו

ראה גם

 עברית