כיצד לעבוד עם הגדרות המסמך ב-.NET
מדריך זה מראה כיצד לעבוד עם הגדרות מסמך ברמת היישום ב-Aspose.Words FOSS עבור .NET: מתגים של תאימות מדור קודם, העדפות מקף, תצורת המיזוג הדואר השמורה, אפשרויות תצוגה והגנה מפני כתיבה. Aspose.Words FOSS עבור .NET זמינה דרך NuGet או על-ידי בנייה ממקור.
מדריך שלב-אחר-שלב
שלב 1: קבל את הספרייה
שכפל את המאגר ובנה Aspose.Words.sln בתצורת Release, ולאחר מכן הוסף הפנייה לפרויקט ל Aspose.Words.csproj מהפרויקט .NET שלך, כפי שמתואר ב מדריך ההתקנה. הוסף using Aspose.Words; and using Aspose.Words.Settings; בראש כל קובץ שקורא או כותב הגדרות מסמך.
שלב 2: הגדר אפשרויות תאימות מדור קודם
Document.CompatibilityOptions (הוא מופע של CompatibilityOptions) מכיל עשרות מתגים בוליאניים המשחזרים התנהגויות פריסה וריווח של Word גרסאות קודמות — לדוגמה GrowAutofit, UseWord2010TableStyleRules, AdjustLineHeightInTable, AlignTablesRowByRow, NoExtraLineSpacing, SuppressSpacingAtTopOfPage ו-SpacingInWholePoints. הגדר ישירות את המאפיינים הפרטניים שאתה צריך; OptimizeFor(MsWordVersion) קיים במחלקה אך גורם ל-NotImplementedException בבנייה זו, ולכן אין קיצור דרך שמיישם פרופיל גרסה שלם בבת אחת.
שלב 3: הגדרת העדפות הפיסוק
Document.HyphenationOptions (מופע של HyphenationOptions) שומר את העדפות הפיסוק של Word עבור המסמך: AutoHyphenation, ConsecutiveHyphenLimit, HyphenateCaps ו-HyphenationZone. מאפיינים אלה מעבירים את הבקשה בקובץ הנשמר; מכיוון שהגרסה הזו אינה כוללת מנוע פריסת דפים, הפסקות הפיסוק מחושבות על ידי Word כאשר הוא פותח ומפריד את הקובץ לעמודים, ולא על ידי Aspose.Words FOSS.
שלב 4: קריאה וכתיבת תצורת מיזוג דואר
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 ו-RecipientDatas מתארים את מיפוי השדות ואת רשימת המקבלים. קריאה וכתיבה של תצורה מאוחסנת זו זמינה בגרסה הקוד-פתוח הזו; הפעלת המיזוג עצמו מול מקור נתונים חי היא עניין נפרד מחוץ לתחום של דף זה.
שלב 5: הגדרת הגדרות תצוגת המסמך
Document.ViewOptions (מופע של ViewOptions) שולט באופן שבו Word מציג את הקובץ לאחר הפתיחה: ViewType, ZoomType, ZoomPercent, DisplayBackgroundShape, DoNotDisplayPageBoundaries ו-FormsDesign. מאפיינים אלה הם העדפות שמורות המשפיעות רק על תצוגת המסמך ב-Word — הם אינם משפיעים על האופן שבו Aspose.Words FOSS עצמו מעבד אותו.
שלב 6: הפעלת הגנת כתיבה
Document.WriteProtection (מופע של WriteProtection) חושף את IsWriteProtected ו-ReadOnlyRecommended, עם SetPassword() ליצירת סיסמת הגנה ו-ValidatePassword() לבדיקה של סיסמה מועמדת מול הסיסמה. יש לקרוא ל-SetPassword() לפני הגדרת IsWriteProtected = true, ולהשתמש ב-ValidatePassword() במקום לאחסן או להשוות את מחרוזת הסיסמה הגולמית בעצמך.
בעיות נפוצות ותיקונים
CompatibilityOptions.OptimizeFor() throws NotImplementedException. שיטה זו אינה מיושמת בבנייה זו. הגדר את ה CompatibilityOptions מאפיינים בוליאניים שאתה צריך ישירות במקום זאת.
Changing ViewOptions.ZoomPercent אין לו השפעה נראית על הפלט שנוצר. ViewOptions היא העדפת תצוגה שנשמרת ונקראת על-ידי Word, ולא משהו ש-Aspose.Words FOSS עצמו מיישם במהלך העיבוד. אין צורך בתיקון — זה מצופה.
WriteProtection.ValidatePassword() מחזיר באופן בלתי צפוי. false. SetPassword() מעולם לא נקרא, או שהוגדרה סיסמה שונה. קראו. SetPassword() קודם כדי להגדיר את הסיסמה המוגנת לפני האימות.
הגדרת מיזוג דואר נשמרת אך המיזוג אינו מתבצע. MailMergeSettings and Odso מאחסן רק את הגדרת המיזוג; גרסה קוד-פתוח זו אינה מריצה את המיזוג בעצמה. קראו את ההגדרה השמורה והניעו את הלוגיקה שלכם למילוי שדות על פיה.
שאלות נפוצות
האם CompatibilityOptions.OptimizeFor() פועל?
לא — זה זורק NotImplementedException בבנייה זו. הגדר ישירות את מאפייני CompatibilityOptions הפרטיים שאתה צריך.
איך אני מגן על מסמך בסיסמה מפני עריכות?
קרא WriteProtection.SetPassword() על Document.WriteProtection, ואז הגדר את IsWriteProtected כדי להפעיל הגנה.
האם HyphenationOptions ו-ViewOptions משנים את המראה של המסמך כאשר Aspose.Words FOSS מעבד אותו?
לא. שניים אלה הם העדפות שמורות ש-Word עצמו מיישם כאשר הוא פותח ומציג את הקובץ; לגרסה זו אין מנוע פריסת עמודים לפעול עליהם ישירות.
היכן אני מוצא את תצורת מקור הנתונים של mail-merge עבור מקור נתונים חיצוני?
MailMergeSettings.Odso — האוספים שלו FieldMapDatas ו-RecipientDatas מתארים את מיפוי העמודות ואת מצב הכללה של הנמענים.
מה ההבדל בין Document.CompatibilityOptions ל-Document.ViewOptions?
CompatibilityOptions המתגים משחזרים את פריסת Word הישנה ואת חוסר האחידות בריווחים; ViewOptions שולט איך הממשק של Word מציג את הקובץ (תקריב, סימני פורמט). אף אחד מהם אינו מחושב על ידי Aspose.Words FOSS עצמו.