ציין אפשרויות טעינה
בעת טעינת מסמך, באפשרותך להגדיר כמה מאפיינים מתקדמים. Aspose.Words מספק לך את הכיתה LoadOptions, המאפשרת שליטה מדויקת יותר בתהליך העומס. בחלק מהפורמטים של עומס יש מחלקה מתאימה שמכילה אפשרויות עומס עבור פורמט עומס זה, לדוגמה, יש PdfLoadOptions לטעינה ל PDF פורמט או TxtLoadOptions לטעינה ל TXT. מאמר זה מספק דוגמאות לעבודה עם אפשרויות של הכיתה LoadOptions.
הגדר Microsoft Word גרסה כדי לשנות את המראה
גרסאות שונות של היישום Microsoft Word יכולות להציג מסמכים באדישות. לדוגמה, יש בעיה ידועה עם OOXML מסמכים כגון DOCX או DOTX המיוצר באמצעות WPS משרד. במקרה כזה, אלמנטים חיוניים של סימון מסמכים עשויים להיות חסרים או עשויים להיות מפורשים באופן שונה, מה שגורם ל Microsoft Word 2019 להציג מסמך כזה באופן שונה בהשוואה ל Microsoft Word 2010.
כברירת מחדל Aspose.Words פותח מסמכים באמצעות Microsoft Word 2019 כללים. אם אתה צריך לעשות זאת כדי לגרום לטעינת המסמך להופיע כפי שהיה קורה באחת מגרסאות היישום הקודמות Microsoft Word, עליך לציין במפורש את הגרסה הרצויה באמצעות המאפיין MswVersion של הכיתה LoadOptions.
דוגמת הקוד הבאה מראה כיצד להגדיר את הגרסה Microsoft Word עם אפשרויות טעינה:
הגדר העדפות שפה כדי לשנות את המראה
הפרטים של הצגת מסמך ב Microsoft Word תלויים לא רק בגרסת היישום ובערך המאפיין MswVersion אלא גם בהגדרות השפה. Microsoft Word עשוי להציג מסמכים באופן שונה בהתאם להגדרות הדו-שיח “העדפות שפת משרד”, שניתן למצוא ב"קובץ אפשרויות שפות". באמצעות תיבת דו-שיח זו משתמש יכול לבחור, למשל, שפה ראשית, שפות הגהה, שפות תצוגה וכן הלאה. Aspose.Words מספק את המאפיין LanguagePreferences כמקבילה לדיאלוג זה. אם Aspose.Words הפלט שונה מהפלט Microsoft Word, הגדר את הערך המתאים עבור EditingLanguage - זה יכול לשפר את מסמך הפלט.
דוגמת הקוד הבאה מראה כיצד להגדיר יפנית כ EditingLanguage:
השתמש ב WarningCallback כדי לשלוט בבעיות בעת טעינת מסמך
מסמכים מסוימים עשויים להיות פגומים, מכילים ערכים לא חוקיים או שיש להם תכונות שאינן נתמכות כרגע על ידי Aspose.Words. אם ברצונך לדעת על בעיות שהתרחשו בעת טעינת מסמך, Aspose.Words מספק את הממשק IWarningCallback.
דוגמת הקוד הבאה מראה את יישום ממשק IWarningCallback:
כדי לקבל מידע על כל הבעיות לאורך זמן הטעינה, השתמש במאפיין WarningCallback.
דוגמת הקוד הבאה מראה כיצד להשתמש במאפיין זה:
השתמש ResourceLoadingCallback כדי לשלוט על טעינת המשאבים החיצוניים
מסמך עשוי להכיל קישורים חיצוניים לתמונות הממוקמות איפשהו בדיסק, ברשת או באינטרנט מקומיים. Aspose.Words טוען תמונות כאלה באופן אוטומטי למסמך, אך ישנם מצבים בהם יש לשלוט בתהליך זה. לדוגמה, כדי להחליט אם אנחנו באמת צריכים לטעון תמונה מסוימת או אולי לדלג עליה. אפשרות הטעינה ResourceLoadingCallback מאפשרת לך לשלוט בזה.
דוגמת הקוד הבאה מראה את יישום ממשק IResourceLoadingCallback:
דוגמת הקוד הבאה מראה כיצד להשתמש במאפיין ResourceLoadingCallback:
השתמש TempFolder כדי למנוע חריג זיכרון
Aspose.Words תומך במסמכים גדולים במיוחד שיש בהם אלפי עמודים מלאים בתוכן עשיר. טעינת מסמכים כאלה עשויה לדרוש הרבה RAM. בתהליך הטעינה, Aspose.Words צריך עוד יותר זיכרון כדי להחזיק מבנים זמניים המשמשים לניתוח מסמך.
אם יש לך בעיה עם החריג מחוץ לזיכרון בעת טעינת מסמך, נסה להשתמש במאפיין TempFolder. במקרה זה, Aspose.Words יאחסן נתונים מסוימים בקבצים זמניים במקום בזיכרון, וזה יכול לעזור למנוע חריג כזה.
דוגמת הקוד הבאה מראה כיצד להגדיר TempFolder:
הגדר את הקידוד במפורש
רוב פורמטי המסמכים המודרניים מאחסנים את התוכן שלהם באוניקוד ואינם דורשים טיפול מיוחד. מצד שני, עדיין ישנם מסמכים רבים המשתמשים בקידוד קדם-יוניקוד כלשהו ולעיתים מפספסים מידע קידוד או אפילו אינם תומכים במידע קידוד מטבעו. Aspose.Words מנסה לזהות באופן אוטומטי את הקידוד המתאים כברירת מחדל, אך במקרה נדיר ייתכן שיהיה עליך להשתמש בקידוד שונה מזה שזוהה על ידי אלגוריתם זיהוי הקידוד שלנו. במקרה זה, השתמש במאפיין Encoding כדי לקבל או להגדיר את הקידוד.
דוגמת הקוד הבאה מראה כיצד להגדיר את הקידוד כדי לעקוף את הקידוד שנבחר באופן אוטומטי:
טען מסמכים מוצפנים
ניתן לטעון Word מסמכים מוצפנים באמצעות סיסמה. לשם כך, השתמש בעומס קונסטרוקטור מיוחד, המקבל אובייקט LoadOptions. אובייקט זה מכיל את המאפיין Password, המציין את מחרוזת הסיסמה.
דוגמת הקוד הבאה מראה כיצד לטעון מסמך מוצפן באמצעות סיסמה:
אם אינך יודע מראש אם הקובץ מוצפן, תוכל להשתמש בכיתה FileFormatUtil, המספקת שיטות שירות לעבודה עם פורמטים של קבצים, כגון זיהוי פורמט הקובץ או המרת סיומות קבצים אל/ממספרי פורמט הקובץ. כדי לזהות אם המסמך מוצפן ודורש סיסמה כדי לפתוח אותו, השתמש במאפיין IsEncrypted.
דוגמת הקוד הבאה מראה כיצד לאמת OpenDocument או שהוא מוצפן או לא: