פתרון בעיות Aspose.Words FOSS for .NET

דף זה מכסה בעיות נפוצות שנפגשות בעת בנייה ושימוש ב-Aspose.Words FOSS עבור .NET, וכן כיצד לפתור אותן.

בעיות בנייה והתקנה

dotnet add package Aspose.Words לא מצליח למצוא את החבילה

הפקודה הזו מתפרשת לחבילה המסחרית Aspose.Words, ולא לגרסת ה-FOSS — מזהה חבילת ה-FOSS הוא Aspose.Words.FOSS:

dotnet add package Aspose.Words.FOSS

חלופית, הפעל את git clone כדי לקבל את הקוד, לאחר מכן cd לתיקייה המשוכפלת והפעל את dotnet build על הפתרון:

git clone https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git
cd Aspose.Words-FOSS-for-.NET
dotnet build Aspose.Words.sln -c Release

לאחר מכן הוסף הפנייה לפרויקט ל-Aspose.Words.csproj מהיישום שלך במקום הפנייה לחבילה.

ההפנייה לפרויקט אינה נפתרת לאחר השכפול.

אשר שההפנייה מציינת את Aspose.Words.csproj בתוך תיקיית Aspose.Words-FOSS-for-.NET/Aspose.Words/ המשוכפלת, ושפתרון נבנה בהצלחה תחילה (dotnet build Aspose.Words.sln -c Release). הספרייה ממקדת את .NET Standard 2.0, ולכן כל SDK המיועד ל-.NET Framework 4.6.2+ או ל-.NET 6/8/10 יכול להפנות אליה.

בעיות טעינה

UnsupportedFileFormatException בעת טעינת מסמך

UnsupportedFileFormatException נזרק במהלך הטעינה כאשר פורמט הקובץ אינו מזוהה או אינו נתמך על ידי גרסה זו. פורמטי הטעינה של גרסה זו הם DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown, וטקסט פשוט — העברת נתיב שאינו נתמך כגון input.doc לבונה Document גורמת להקפצת חריגה זו במקום להחזיר מסמך טעון:

using Aspose.Words;

try
{
    Document doc = new Document("input.doc");
}
catch (UnsupportedFileFormatException ex)
{
    Console.WriteLine("Format not supported by this edition: " + ex.Message);
}

תפיסת UnsupportedFileFormatException סביב הבונה Document מאפשרת לך לדווח על הודעה ברורה במקום לאפשר לחריגה להתפשט כמעקב ערימה גולמי.

FileCorruptedException על קובץ שנראה תקין

FileCorruptedException נזרק במהלך הטעינה כאשר הקובץ נראה פגום ולא ניתן לפענח — למשל, קובץ .docx שאינו חבילת OOXML מבוססת ZIP תקינה, או קובץ שנחתך במהלך ההעברה. קבל מחדש את הקובץ מהמקור שלו ואשר שהוא נפתח כראוי לפני הטעינה עם Document.

IncorrectPasswordException בעת פתיחת מסמך מוגן

זה נזרק כאשר מסמך מוצפן עם סיסמה והסיסמה שסופקה למעמד Document בגרסת LoadOptions חסרה או שגויה. ספק את הסיסמה הנכונה דרך LoadOptions.Password לפני הטעינה.

בעיות שמירה וייצוא

Document.Save() ל-PDF, XPS, או סיומת תמונה נכשלת

גרסה זו אינה כוללת את תת-מערכת פריסת העמוד וההדמיה, ולכן Document.Save() אינה יכולה לייצא ל-PDF, XPS, או פורמטים של תמונות.

שמור ל-DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown, או טקסט רגיל במקום — אלה הם הפורמטים שהגרסה הזאת בפועל כותבת. המסחרי Aspose.Words עבור .NET מוסיף PDF, XPS ופלט תמונה.

מספרי העמודים וערכי תוכן העניינים תמיד מציגים 0

Aspose.Words FOSS עבור .NET כולל מנוע הערכת שדות מלא, ולכן שדות תוכן כגון DATE ו-DOCPROPERTY מתעדכנים כראוי. שדות שתלויים בתצורת העמוד — מספרי עמודים, NUMPAGES, ורשומות תוכן — מחזירים את המחליף 0 במקום ערך מחושב, מכיוון שהגרסה הזו לא כוללת את מנוע הפריסה שהיה ממלא בדרך כלל את העמודים במסמך. זהו התנהגות צפויה בגרסה זו, ולא באג.

בעיות חתימה דיגיטלית

חתימה על מסמך אינה משפיעה

DigitalSignatureUtil.Sign() וה-API-ים הקשורים לחתימה קיימים במודל האובייקט לתיאום מבני עם המוצר המסחרי, אך יצירת חתימה חדשה אינה מתפקדת בגרסת FOSS זו — קריאה אליהם אינה מייצרת פלט חתום. גרסה זו יכולה לבדוק ולאמת חתימות שכבר מצורפות למסמך דרך Document.DigitalSignatures ו-DigitalSignatureUtil.LoadSignatures(), אך תהליך חתימה דורש את Aspose.Words המסחרי עבור .NET.

בעיות גופנים

הגופנים המשובצים גדולים יותר מהצפוי

כאשר EmbedTrueTypeFonts מופעל, הגופנים משובצים כהקבצים המלאים במקום להיות מצומצמים רק לכל הגליפים שבאמת משמשים במסמך, ולכן הקבצים הנשמרים עם גופנים משובצים גדולים יותר מהפלט המקביל מהמוצר המסחרי. אין פתרון חלופי בגרסה זו — צמצום גופנים משובצים אינו נכלל.