Depanare Aspose.Words FOSS for .NET

Această pagină acoperă problemele comune întâlnite la construirea și utilizarea Aspose.Words FOSS pentru .NET, și cum să le rezolvi.

Probleme de construire și instalare

dotnet add package Aspose.Words nu poate găsi pachetul

Acea comandă se rezolvă la pachetul comercial Aspose.Words, nu la ediția FOSS — ID-ul pachetului FOSS este Aspose.Words.FOSS:

dotnet add package Aspose.Words.FOSS

Alternativ, rulează git clone pentru a obține sursa, apoi cd în folderul clonat și rulează dotnet build pe soluție:

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

Apoi adăugați o referință de proiect la Aspose.Words.csproj din propria aplicație în loc de o referință la pachet.

Referința de proiect nu se rezolvă după clonare

Confirmați că referința indică spre Aspose.Words.csproj din folderul Aspose.Words-FOSS-for-.NET/Aspose.Words/ clonat și că soluția a fost construită cu succes mai întâi (dotnet build Aspose.Words.sln -c Release). Biblioteca vizează .NET Standard 2.0, așa că orice SDK care vizează .NET Framework 4.6.2+ sau .NET 6/8/10 o poate referenția.

Probleme la încărcare

UnsupportedFileFormatException la încărcarea unui document

UnsupportedFileFormatException este aruncată în timpul încărcării când formatul fișierului nu este recunoscut sau nu este suportat de această ediție. Formatele de încărcare ale acestei ediții sunt DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown și text simplu — trecerea unei căi nesuportate, cum ar fi input.doc, la constructorul Document declanșează această excepție în loc să returneze un document încărcat:

using Aspose.Words;

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

Capturarea lui UnsupportedFileFormatException în jurul constructorului Document vă permite să raportați un mesaj clar în loc să lăsați excepția să se propage ca o urmă de stivă brută.

FileCorruptedException pe un fișier care pare valid

FileCorruptedException este aruncat în timpul încărcării când fișierul pare corupt și nu poate fi analizat — de exemplu, un fișier .docx care nu este un pachet OOXML bazat pe ZIP valid, sau un fișier trunchiat în timpul transferului. Obțineți din nou fișierul de la sursa sa și confirmați că se deschide corect înainte de a-l încărca cu Document.

IncorrectPasswordException la deschiderea unui document protejat

Aceasta este aruncată când un document este criptat cu o parolă și parola furnizată constructorului Document în suprasarcina LoadOptions lipsește sau este incorectă. Furnizați parola corectă prin LoadOptions.Password înainte de încărcare.

Probleme la salvare și export

Document.Save() către o extensie PDF, XPS sau imagine eșuează

Această ediție nu include subsistemul de aranjare a paginilor și randare, astfel că Document.Save() nu poate exporta în formatele PDF, XPS sau imagine.

Salvați în DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown sau text simplu în schimb — acestea sunt formatele pe care această ediție le scrie efectiv. Versiunea comercială Aspose.Words pentru .NET adaugă PDF, XPS și ieșire de imagini.

Numerele de pagină și intrările din cuprins afișează întotdeauna 0

Aspose.Words FOSS pentru .NET include un motor complet de evaluare a câmpurilor, astfel încât câmpurile de conținut precum DATE și DOCPROPERTY se actualizează corect. Câmpurile care depind de aspectul paginii — numerele de pagină, NUMPAGES, și intrările din Cuprins — evaluează la un 0 în loc de o valoare calculată, deoarece această ediție nu include motorul de aspect care ar pagina în mod normal documentul. Acesta este comportamentul așteptat în această ediție, nu un bug.

Probleme cu semnăturile digitale

Semnarea unui document nu are niciun efect

DigitalSignatureUtil.Sign() și API-urile de semnare aferente există în modelul de obiecte pentru compatibilitate structurală cu produsul comercial, dar crearea unei noi semnături nu este funcțională în această ediție FOSS — apelarea lor nu produce un rezultat semnat. Această ediție poate inspecta și verifica semnăturile deja atașate unui document prin Document.DigitalSignatures și DigitalSignatureUtil.LoadSignatures(), dar un flux de lucru de semnare necesită Aspose.Words comercial pentru .NET.

Probleme cu fonturile

Fonturile încorporate sunt mai mari decât se așteaptă

Când EmbedTrueTypeFonts este activat, fonturile sunt încorporate ca fișiere întregi în loc să fie subselectate la doar glifele efectiv utilizate în document, astfel fișierele salvate care încorporează fonturi sunt mai mari decât rezultatul echivalent al produsului comercial. Nu există nicio soluție alternativă în această ediție — subselectarea fonturilor încorporate nu este inclusă.