Risoluzione dei problemi Aspose.Words FOSS for .NET

Questa pagina tratta i problemi comuni riscontrati durante la compilazione e l’uso di Aspose.Words FOSS per .NET, e come risolverli.

Problemi di compilazione e installazione

dotnet add package Aspose.Words non riesce a trovare il pacchetto

Quel comando punta al pacchetto commerciale Aspose.Words, non all’edizione FOSS — l’ID del pacchetto FOSS è Aspose.Words.FOSS:

dotnet add package Aspose.Words.FOSS

In alternativa, esegui git clone per ottenere il sorgente, poi cd nella cartella clonata ed esegui dotnet build sulla soluzione:

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

Quindi aggiungi un riferimento al progetto Aspose.Words.csproj dalla tua applicazione anziché un riferimento a un pacchetto.

Il riferimento al progetto non si risolve dopo il clone.

Conferma che il riferimento punti a Aspose.Words.csproj all’interno della cartella Aspose.Words-FOSS-for-.NET/Aspose.Words/ clonata e che la soluzione sia stata prima compilata correttamente (dotnet build Aspose.Words.sln -c Release). La libreria ha come target .NET Standard 2.0, quindi qualsiasi SDK che abbia come target .NET Framework 4.6.2+ o .NET 6/8/10 può fare riferimento ad essa.

Problemi di caricamento

UnsupportedFileFormatException durante il caricamento di un documento

UnsupportedFileFormatException viene generato durante il caricamento quando il formato del file non è riconosciuto o non è supportato da questa edizione. I formati di caricamento di questa edizione sono DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown e testo semplice — passare un percorso non supportato come input.doc al costruttore Document solleva questa eccezione invece di restituire un documento caricato:

using Aspose.Words;

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

Catturare UnsupportedFileFormatException attorno al costruttore Document ti consente di segnalare un messaggio chiaro invece di lasciare che l’eccezione si propaghi come una traccia di stack grezza.

FileCorruptedException su un file che sembra valido

FileCorruptedException viene lanciato durante il caricamento quando il file sembra corrotto e non può essere analizzato — ad esempio, un file .docx che non è un pacchetto OOXML basato su ZIP valido, oppure un file troncato durante il trasferimento. Recupera nuovamente il file dalla sua origine e verifica che si apra correttamente prima di caricarlo con Document.

IncorrectPasswordException durante l’apertura di un documento protetto

Viene lanciato quando un documento è crittografato con una password e la password fornita al sovraccarico LoadOptions del costruttore Document è mancante o errata. Fornisci la password corretta tramite LoadOptions.Password prima del caricamento.

Problemi di salvataggio ed esportazione

Document.Save() in PDF, XPS o estensione immagine fallisce

Questa edizione non include il sottosistema di layout di pagina e rendering, quindi Document.Save() non può esportare in PDF, XPS o formati immagine.

Salva in DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown o testo semplice invece — questi sono i formati che questa edizione scrive effettivamente. Il commerciale Aspose.Words per .NET aggiunge PDF, XPS e output immagine.

I numeri di pagina e le voci dell’indice mostrano sempre 0

Aspose.Words FOSS per .NET include un motore completo di valutazione dei campi, quindi i campi di contenuto come DATE e DOCPROPERTY si aggiornano correttamente. I campi che dipendono dal layout della pagina — numeri di pagina, NUMPAGES, e voci dell’indice — valutano a un segnaposto 0 invece di un valore calcolato, perché questa edizione non include il motore di layout che normalmente impagina il documento. Questo è un comportamento previsto in questa edizione, non un bug.

Problemi di firma digitale

Firmare un documento non ha alcun effetto

DigitalSignatureUtil.Sign() e le API di firma correlate esistono nel modello oggetto per compatibilità strutturale con il prodotto commerciale, ma la creazione di una nuova firma non è funzionale in questa edizione FOSS — chiamarle non produce un output firmato. Questa edizione può ispezionare e verificare le firme già allegate a un documento tramite Document.DigitalSignatures e DigitalSignatureUtil.LoadSignatures(), ma un flusso di lavoro di firma richiede il Aspose.Words commerciale per .NET.

Problemi di font

I font incorporati sono più grandi del previsto

Quando EmbedTrueTypeFonts è abilitato, i font vengono incorporati come file interi anziché essere sottoposti a subset solo ai glifi effettivamente utilizzati nel documento, quindi i file salvati che incorporano i font sono più grandi dell’output equivalente del prodotto commerciale. Non esiste una soluzione alternativa in questa edizione — il subset dei font incorporati non è incluso.