Řešení problémů Aspose.Words FOSS for .NET

Tato stránka popisuje běžné problémy, se kterými se setkáváte při sestavování a používání Aspose.Words FOSS pro .NET, a jak je řešit.

Problémy se sestavením a instalací

dotnet add package Aspose.Words nemůže najít balíček

Tento příkaz odkazuje na komerční balíček Aspose.Words, nikoli na FOSS edici — ID FOSS balíčku je Aspose.Words.FOSS:

dotnet add package Aspose.Words.FOSS

Alternativně spusťte git clone pro získání zdrojového kódu, poté cd do naklonované složky a spusťte dotnet build na řešení:

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

Pak přidejte projektovou referenci na Aspose.Words.csproj z vaší vlastní aplikace místo referencí na balíček.

Projektová reference se po naklonování nevyřeší

Potvrďte, že reference ukazuje na Aspose.Words.csproj uvnitř naklonovaného Aspose.Words-FOSS-for-.NET/Aspose.Words/ složky a že řešení bylo nejprve úspěšně sestaveno (dotnet build Aspose.Words.sln -c Release). Knihovna cílí na .NET Standard 2.0, takže jakékoli SDK cílené na .NET Framework 4.6.2+ nebo .NET 6/8/10 ji může odkazovat.

Problémy s načítáním

UnsupportedFileFormatException při načítání dokumentu

UnsupportedFileFormatException je vyvolána během načítání, když formát souboru není rozpoznán nebo není podporován touto edicí. Formáty načítání této edice jsou DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown a prostý text — předání nepodporované cesty, jako je input.doc, konstruktoru Document vyvolá tuto výjimku místo vrácení načteného dokumentu:

using Aspose.Words;

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

Zachycení UnsupportedFileFormatException kolem konstruktoru Document vám umožní nahlásit srozumitelnou zprávu místo toho, aby se výjimka šířila jako surový zásobník volání.

FileCorruptedException na souboru, který vypadá platně

FileCorruptedException je vyvolána při načítání, když soubor vypadá poškozený a nelze jej parsovat — například soubor .docx, který není platným ZIP-založeným balíčkem OOXML, nebo soubor zkrácený během přenosu. Získejte soubor znovu ze zdroje a ověřte, že se otevírá správně, než jej načtete pomocí Document.

IncorrectPasswordException při otevírání chráněného dokumentu

Tato výjimka je vyvolána, když je dokument šifrován heslem a heslo předané do přetížení LoadOptions konstruktoru Document chybí nebo je nesprávné. Před načtením zadejte správné heslo pomocí LoadOptions.Password.

Problémy s ukládáním a exportem

Document.Save() do PDF, XPS nebo obrazového formátu selže

Toto vydání neobsahuje subsystém rozvržení stránky a renderování, takže Document.Save() nemůže exportovat do formátů PDF, XPS ani obrazových formátů.

Uložte do DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown nebo prostého textu — to jsou formáty, které tato edice skutečně zapisuje. Komerční Aspose.Words pro .NET přidává výstup PDF, XPS a obrázků.

Čísla stránek a položky obsahu vždy ukazují 0

Aspose.Words FOSS pro .NET obsahuje plnohodnotný engine pro vyhodnocování polí, takže obsahová pole jako DATE a DOCPROPERTY se aktualizují správně. Pole, která závisí na rozvržení stránky — čísla stránek, NUMPAGES a položky obsahu — jsou vyhodnocena na zástupný znak 0 místo vypočtené hodnoty, protože tato edice neobsahuje engine pro rozvržení, který by normálně stránkoval dokument. Toto je v této edici očekávané chování, ne chyba.

Problémy s digitálním podpisem

Podepsání dokumentu nemá žádný efekt

DigitalSignatureUtil.Sign() a související API pro podepisování existují v objektovém modelu pro strukturovanou kompatibilitu s komerčním produktem, ale vytváření nového podpisu v této FOSS edici nefunguje — jejich volání nevytvoří podepsaný výstup. Tato edice může prohlížet a ověřovat podpisy již připojené k dokumentu pomocí Document.DigitalSignatures a DigitalSignatureUtil.LoadSignatures(), ale workflow pro podepisování vyžaduje komerční Aspose.Words pro .NET.

Problémy s fonty

Vložené fonty jsou větší, než se očekávalo

Když je EmbedTrueTypeFonts povoleno, fonty jsou vkládány jako celé soubory místo toho, aby byly podmnoženy pouze na glyfy skutečně použité v dokumentu, takže uložené soubory s vloženými fonty jsou větší než ekvivalentní výstup z komerčního produktu. V této edici neexistuje žádné řešení — podmnožování vložených fontů není zahrnuto.