Dépannage

Problèmes courants et solutions lors de l’utilisation d’Aspose.PDF FOSS pour .NET.

Problème	Cause	Solution
`Document.Open` lève une exception sur un PDF valide	Le fichier est protégé par mot de passe	Fournissez le mot de passe dans le constructeur
Mémoire insuffisante sur de gros PDF	Le fichier entier est chargé dans un tableau d’octets	Traitez les pages individuellement ou utilisez le streaming
`Pages[0]` lève une erreur d’index	Les pages utilisent un indexation à partir de 1	Utilisez `Pages[1]` pour la première page

Problème	Cause	Solution
Annotation non visible après l’enregistrement	Le rectangle a une surface nulle ou est en dehors des limites de la page	Vérifiez que les coordonnées se situent dans la page `MediaBox`
`LinkAnnotation.Uri` renvoie null	Le lien utilise une action GoTo ou JavaScript	Résoudre via `PdfAction.Create` et vérifier `ActionType`
`Flatten()` lève une exception	Référence d’annotation `/P` (page) manquante	Assurez-vous que l’annotation a été ajoutée via `Page.Annotations`

Problem	Cause	Solution
Le texte extrait est illisible	Encodage non standard ou mappage de police CID	Vérifiez l’incorporation des polices ; les PDF numérisés peuvent nécessiter une OCR
Aucun fragment de texte trouvé	Le contenu de la page est une image raster	Utilisez l’OCR avant l’extraction du texte
L’expression régulière ne renvoie aucun résultat	La mise en page du texte PDF insère des espaces	Utilisez un motif plus souple ou normalisez les espaces

Problem	Cause	Solution
L’image rendue est floue	Résolution trop basse	Augmentez le DPI dans le constructeur `Resolution`
La sortie HTML ne contient pas d’images	Chemins d’image externes non configurés	Utilisez `HtmlSaveOptions` avec des images intégrées
La conversion PDF/A supprime les annotations	Le profil cible n’autorise pas les annotations	Utilisez PDF/A-2 ou PDF/A-3

Problem	Cause	Solution
La valeur du champ est vide	Le champ n’a aucune entrée `/V`	Vérifier que `field.Value` n’est pas nul
`FillField` n’a aucun effet	Mauvaise correspondance du nom de champ	Utiliser `Form.FieldNames` pour lister les noms disponibles
ExportToJson produit une sortie vide	Annotation de widget mal convertie	Vérifier que l’annotation est une `WidgetAnnotation`

Toujours envelopper Document dans using pour libérer les poignées de fichier.
Utiliser Document.Open(byte[]) pour les flux de travail en mémoire afin d’éviter les verrous de fichier.
Vérifier doc.Pages.Count avant d’accéder aux pages par indice.
Enregistrer le document une fois après toutes les modifications pour de meilleures performances.

Dépannage

Voir aussi