Усунення проблем 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 при відкритті захищеного документа.

Це генерується, коли документ зашифровано паролем, а пароль, переданий у перевантаження LoadOptions конструктора Document, відсутній або неправильний. Надішліть правильний пароль через 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 увімкнено, шрифти вбудовуються як цілі файли, а не підмножиною лише тих гліфів, які фактично використані в документі, тому збережені файли з вбудованими шрифтами більші, ніж еквівалентний результат комерційного продукту. У цьому виданні немає обхідного рішення — підмножина вбудованих шрифтів не включена.