Dépannage Aspose.Words FOSS for .NET

Cette page couvre les problèmes courants rencontrés lors de la compilation et de l’utilisation de Aspose.Words FOSS pour .NET, ainsi que les solutions pour les résoudre.

Problèmes de compilation et d’installation

dotnet add package Aspose.Words ne trouve pas le paquet

Cette commande résout vers le paquet commercial Aspose.Words, et non l’édition FOSS — l’ID du paquet FOSS est Aspose.Words.FOSS:

dotnet add package Aspose.Words.FOSS

Sinon, exécutez git clone pour récupérer le code source, puis cd dans le dossier cloné et exécutez dotnet build sur la solution:

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

Ajoutez ensuite une référence de projet à Aspose.Words.csproj depuis votre propre application plutôt qu’une référence de package.

La référence de projet ne se résout pas après le clonage.

Confirmez que la référence pointe vers Aspose.Words.csproj à l’intérieur du dossier Aspose.Words-FOSS-for-.NET/Aspose.Words/ cloné, et que la solution a d’abord été compilée avec succès (dotnet build Aspose.Words.sln -c Release). La bibliothèque cible .NET Standard 2.0, de sorte que tout SDK ciblant .NET Framework 4.6.2+ ou .NET 6/8/10 peut y faire référence.

Problèmes de chargement

UnsupportedFileFormatException lors du chargement d’un document

UnsupportedFileFormatException est levée lors du chargement lorsque le format de fichier n’est pas reconnu ou n’est pas pris en charge par cette édition. Les formats de chargement de cette édition sont DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown et texte brut — passer un chemin non pris en charge tel que input.doc au constructeur Document déclenche cette exception au lieu de retourner un document chargé :

using Aspose.Words;

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

Capturer UnsupportedFileFormatException autour du constructeur Document vous permet d’afficher un message clair au lieu de laisser l’exception se propager sous forme de trace de pile brute.

FileCorruptedException sur un fichier qui semble valide

FileCorruptedException est levé lors du chargement lorsque le fichier semble corrompu et ne peut pas être analysé — par exemple, un fichier .docx qui n’est pas un paquet OOXML basé sur ZIP, ou un fichier tronqué pendant le transfert. Récupérez à nouveau le fichier à partir de sa source et confirmez qu’il s’ouvre correctement avant de le charger avec Document.

IncorrectPasswordException lors de l’ouverture d’un document protégé

Cela est levé lorsqu’un document est chiffré avec un mot de passe et que le mot de passe fourni au surcharge LoadOptions du constructeur Document est absent ou incorrect. Fournissez le mot de passe correct via LoadOptions.Password avant le chargement.

Problèmes d’enregistrement et d’exportation

Échec de Document.Save() vers un PDF, XPS ou un format d’image

Cette édition n’inclut pas le sous-système de mise en page et de rendu, de sorte que Document.Save() ne peut pas exporter vers PDF, XPS ou des formats d’image.

Enregistrez au format DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown ou texte brut à la place — ce sont les formats que cette édition écrit réellement. Le commercial Aspose.Words for .NET ajoute la sortie PDF, XPS et image.

Les numéros de page et les entrées de table des matières affichent toujours 0

Aspose.Words FOSS pour .NET comprend un moteur complet d’évaluation de champs, de sorte que les champs de contenu tels que DATE et DOCPROPERTY sont mis à jour correctement. Les champs dépendant de la mise en page — numéros de page, NUMPAGES, et entrées de table des matières — évaluent à un espace réservé 0 au lieu d’une valeur calculée, parce que cette édition n’inclut pas le moteur de mise en page qui paginerait normalement le document. Ce comportement est attendu dans cette édition, ce n’est pas un bug.

Problèmes de signature numérique

Signer un document n’a aucun effet

DigitalSignatureUtil.Sign() et les API de signature associées existent dans le modèle d’objet pour assurer la compatibilité structurelle avec le produit commercial, mais la création d’une nouvelle signature n’est pas fonctionnelle dans cette édition FOSS — les appeler ne produit pas de sortie signée. Cette édition peut inspecter et vérifier les signatures déjà attachées à un document via Document.DigitalSignatures et DigitalSignatureUtil.LoadSignatures(), mais un flux de travail de signature nécessite le Aspose.Words commercial pour .NET.

Problèmes de polices

Les polices incorporées sont plus volumineuses que prévu

Lorsque EmbedTrueTypeFonts est activé, les polices sont incorporées en tant que fichiers complets plutôt que d’être sous-ensemble aux seuls glyphes réellement utilisés dans le document, de sorte que les fichiers enregistrés qui incorporent des polices sont plus volumineux que la sortie équivalente du produit commercial. Il n’existe aucune solution de contournement dans cette édition — le sous-ensemble des polices incorporées n’est pas inclus.