Hibaelhárítás Aspose.Words FOSS for .NET

Ez az oldal lefedi a gyakori problémákat, amelyek a Aspose.Words FOSS .NET felépítése és használata során merülnek fel, és bemutatja azok megoldását.

Építési és telepítési problémák

dotnet add package Aspose.Words nem találja a csomagot

Az a parancs a kereskedelmi Aspose.Words csomagra mutat, nem a FOSS kiadásra — a FOSS csomagazonosító Aspose.Words.FOSS:

dotnet add package Aspose.Words.FOSS

Alternatívaként futtassa a git clone parancsot a forrás lekéréséhez, majd cd a klónozott mappába, és futtassa a dotnet build parancsot a megoldáson:

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

Ezután adjon hozzá egy projektreferenciát a Aspose.Words.csproj elemre a saját alkalmazásából a csomagreferencia helyett.

A projektreferencia nem oldódik fel a klónozás után.

Ellenőrizze, hogy a hivatkozás a klónozott Aspose.Words-FOSS-for-.NET/Aspose.Words/ mappán belül a Aspose.Words.csproj elemre mutat, és hogy a megoldás először sikeresen felépült-e (dotnet build Aspose.Words.sln -c Release). A könyvtár a .NET Standard 2.0-ra céloz, ezért bármely .NET Framework 4.6.2+ vagy .NET 6/8/10 SDK hivatkozhat rá.

Betöltési problémák

UnsupportedFileFormatException egy dokumentum betöltésekor

UnsupportedFileFormatException dobódik a betöltés során, ha a fájlformátum nem felismert vagy nem támogatott ebben a kiadásban. Ennek a kiadásnak a betöltési formátumai a DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown és a egyszerű szöveg — ha egy nem támogatott útvonalat, például input.doc, ad át a Document konstruktorának, akkor ez a kivétel keletkezik a betöltött dokumentum visszaadása helyett:

using Aspose.Words;

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

A UnsupportedFileFormatException elkapása a Document konstruktor körül lehetővé teszi, hogy egyértelmű üzenetet jelentsen, ahelyett, hogy a kivétel nyers stack trace-ként terjedne tovább.

FileCorruptedException egy érvényesnek tűnő fájlon

FileCorruptedException akkor dobódik a betöltés során, amikor a fájl sérültnek tűnik és nem lehet azt feldolgozni — például egy .docx fájl, amely nem érvényes ZIP-alapú OOXML csomag, vagy egy átvitel közben levágott fájl. Szerezze be újra a fájlt a forrásából, és ellenőrizze, hogy helyesen megnyílik-e, mielőtt Document-vel betöltené.

IncorrectPasswordException védett dokumentum megnyitásakor

Ez akkor dobódik, amikor egy dokumentum jelszóval van titkosítva, és a Document konstruktor LoadOptions túlterheléséhez megadott jelszó hiányzik vagy helytelen. A helyes jelszót a LoadOptions.Password segítségével adja meg a betöltés előtt.

Mentési és exportálási problémák

Document.Save() PDF, XPS vagy képkiterjesztésre történő mentése sikertelen

Ez a kiadás nem tartalmazza az oldalelrendezési és renderelési alrendszert, ezért a Document.Save() nem képes PDF, XPS vagy képadatformátumokba exportálni.

Mentse DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown vagy egyszerű szöveg formátumba — ezek azok a formátumok, amelyeket ez a kiadás valójában ír. A kereskedelmi Aspose.Words a .NET számára hozzáadja a PDF, XPS és képkimenetet.

Az oldalszámok és a tartalomjegyzék bejegyzései mindig 0-t mutatnak

Aspose.Words FOSS a .NET számára teljes mezőértékelő motorral rendelkezik, így a tartalmi mezők, például DATE és DOCPROPERTY helyesen frissülnek. A lapelrendezéstől függő mezők — oldalszámok, NUMPAGES, és TOC bejegyzések — egy 0 helyőrzőre értékelődnek a számított érték helyett, mivel ez a kiadás nem tartalmazza azt a layout motort, amely normál esetben oldalszámozza a dokumentumot. Ez a viselkedés ebben a kiadásban várható, nem hiba.

Digitális aláírási problémák

A dokumentum aláírása nem jár hatással

DigitalSignatureUtil.Sign() és a kapcsolódó aláírási API-k léteznek az objektummodellben a kereskedelmi termékkel való szerkezeti kompatibilitás érdekében, de új aláírás létrehozása nem működik ebben a FOSS kiadásban — a hívásuk nem eredményez aláírt kimenetet. Ez a kiadás képes megvizsgálni és ellenőrizni a dokumentumhoz már csatolt aláírásokat a Document.DigitalSignatures és a DigitalSignatureUtil.LoadSignatures() segítségével, de egy aláírási munkafolyamat a .NET számára a kereskedelmi Aspose.Words használatát igényli.

Betűkészlet-problémák

A beágyazott betűkészletek nagyobbak a várt méretnél

Ha a EmbedTrueTypeFonts engedélyezve van, a betűkészletek egész fájlként kerülnek beágyazásra, ahelyett, hogy csak a dokumentumban ténylegesen használt glifjekre lenne részhalmazozva, ezért a betűkészleteket beágyazó mentett fájlok nagyobbak a kereskedelmi termék ekvivalens kimeneténél. Ebben a kiadásban nincs megoldás — a beágyazott betűkészlet részhalmazozás nincs benne.