Felsökning Aspose.Words FOSS for .NET

Den här sidan täcker vanliga problem som uppstår när man bygger och använder Aspose.Words FOSS för .NET, och hur man löser dem.

Bygg- och installationsproblem

dotnet add package Aspose.Words kan inte hitta paketet

Det kommandot pekar på det kommersiella Aspose.Words-paketet, inte FOSS-utgåvan — FOSS-paket-ID:t är Aspose.Words.FOSS:

dotnet add package Aspose.Words.FOSS

Alternativt, kör git clone för att hämta källkoden, sedan cd i den klonade mappen och kör dotnet build på lösningen:

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

Lägg sedan till en projektreferens till Aspose.Words.csproj från din egen applikation istället för en paketreferens.

Projektreferensen löser sig inte efter kloning

Bekräfta att referensen pekar på Aspose.Words.csproj i den klonade Aspose.Words-FOSS-for-.NET/Aspose.Words/-mappen, och att lösningen byggdes framgångsrikt först (dotnet build Aspose.Words.sln -c Release). Biblioteket riktar sig mot .NET Standard 2.0, så alla SDK:er som riktar sig mot .NET Framework 4.6.2+ eller .NET 6/8/10 kan referera det.

Laddningsproblem

UnsupportedFileFormatException när ett dokument laddas

UnsupportedFileFormatException kastas under inläsning när filformatet inte känns igen eller inte stöds av den här utgåvan. Den här utgåvans inläsningsformat är DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown och vanlig text — att ange en ej stödjd sökväg som input.doc till Document constructor utlöser detta undantag istället för att returnera ett inläst dokument:

using Aspose.Words;

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

Att fånga UnsupportedFileFormatException runt Document constructor låter dig rapportera ett tydligt meddelande istället för att låta undantaget propagera som en raw stack trace.

FileCorruptedException på en fil som ser giltig ut

FileCorruptedException kastas under inläsning när filen verkar vara korrupt och kan inte tolkas — till exempel en .docx-fil som inte är ett giltigt ZIP-baserat OOXML-paket, eller en fil som avbrutits under överföringen. Hämta filen på nytt från dess källa och bekräfta att den öppnas korrekt innan du laddar den med Document.

IncorrectPasswordException vid öppning av ett skyddat dokument

Detta kastas när ett dokument är krypterat med ett lösenord och lösenordet som angavs till Document-konstruktorns LoadOptions-överkurs är saknat eller felaktigt. Ange rätt lösenord via LoadOptions.Password innan inläsning.

Problem med sparande och export

Document.Save() till en PDF, XPS eller bildfil misslyckas

Denna utgåva innehåller inte delsystemet för sidlayout och rendering, så Document.Save() kan inte exportera till PDF, XPS eller bildformat.

Spara som DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown eller plain text istället — det är de format som den här utgåvan faktiskt skriver. Den kommersiella Aspose.Words för .NET lägger till PDF, XPS och bildutmatning.

Sidnummer och innehållsförteckningsposter visar alltid 0

Aspose.Words FOSS för .NET inkluderar en fullständig fältutvärderingsmotor, så innehållsfält som DATE och DOCPROPERTY uppdateras korrekt. Fält som beror på sidlayout — sidnummer, NUMPAGES och TOC-poster — utvärderas till en platshållare 0 istället för ett beräknat värde, eftersom den här utgåvan inte innehåller layoutmotorn som normalt paginerar dokumentet. Detta är förväntat beteende i denna utgåva, inte en bugg.

Problem med digitala signaturer

Att signera ett dokument har ingen effekt

DigitalSignatureUtil.Sign() och de relaterade signerings-API:erna finns i objektmodellen för strukturell kompatibilitet med den kommersiella produkten, men att skapa en ny signatur fungerar inte i denna FOSS-utgåva — att anropa dem genererar ingen signerad output. Denna utgåva kan inspektera och verifiera signaturer som redan är bifogade till ett dokument via Document.DigitalSignatures och DigitalSignatureUtil.LoadSignatures(), men ett signeringsflöde kräver den kommersiella Aspose.Words för .NET.

Problem med typsnitt

Inbäddade typsnitt är större än förväntat

När EmbedTrueTypeFonts är aktiverat, bäddas typsnitt in som hela filer istället för att begränsas till endast de tecken som faktiskt används i dokumentet, så sparade filer som inbäddar typsnitt är större än motsvarande output från den kommersiella produkten. Det finns ingen lösning i denna utgåva — subsetting av inbäddade typsnitt är inte inkluderat.