Troubleshooting

Veelvoorkomende problemen en oplossingen bij het werken met Aspose.PDF FOSS voor .NET.

Problem	Oorzaak	Solution
`Document.Open` gooit een fout bij een geldig PDF	Bestand is beveiligd met een wachtwoord	Geef het wachtwoord op in de constructor
Out of memory bij grote PDF’s	Heel bestand geladen in een byte-array	Verwerk pagina’s afzonderlijk of gebruik streaming
`Pages[0]` gooit een indexfout	Pagina’s gebruiken 1-gebaseerde indexering	Gebruik `Pages[1]` voor de eerste pagina

Problem	Oorzaak	Solution
Annotatie niet zichtbaar na opslaan	Rechthoek heeft nul oppervlakte of ligt buiten de paginagrenzen	Verifieer dat coördinaten binnen de pagina `MediaBox` vallen
`LinkAnnotation.Uri` retourneert null	Link gebruikt een GoTo of JavaScript actie	Los op via `PdfAction.Create` en controleer `ActionType`
`Flatten()` gooit	Annotatie mist `/P` (pagina) referentie	Zorg ervoor dat de annotatie is toegevoegd via `Page.Annotations`

Problem	Oorzaak	Solution
De geëxtraheerde tekst is onleesbaar	Niet-standaard codering of CID-lettertypekoppeling	Controleer lettertype-insluiting; gescande PDF’s hebben mogelijk OCR nodig
Geen tekstfragmenten gevonden	Paginasinhoud is een rasterafbeelding	Gebruik OCR vóór tekstextractie
Regex levert geen overeenkomsten op	PDF-tekstlay-out voegt spaties in	Gebruik een lossere patroon of normaliseer spaties

Problem	Oorzaak	Solution
Gerenderde afbeelding is wazig	Resolutie te laag	Verhoog DPI in `Resolution` constructor
HTML output mist afbeeldingen	Externe afbeeldingspaden niet geconfigureerd	Gebruik `HtmlSaveOptions` met ingesloten afbeeldingen
PDF/A conversie verwijdert annotaties	Doelprofiel staat annotaties niet toe	Gebruik PDF/A-2 of PDF/A-3

Problem	Oorzaak	Solution
Veldwaarde is leeg	Veld heeft geen `/V` invoer	Controleer dat `field.Value` niet null is
`FillField` heeft geen effect	Veldnaam komt niet overeen	Gebruik `Form.FieldNames` om beschikbare namen te tonen
ExportToJson produceert lege output	Widget-annotatie niet correct gecast	Controleer of de annotatie een `WidgetAnnotation` is

Omhul Document in using om bestandshandles vrij te geven.
Gebruik Document.Open(byte[]) voor in-memory workflows om bestandsvergrendelingen te voorkomen.
Controleer doc.Pages.Count voordat je pagina’s via index benadert.
Sla het document één keer op na alle wijzigingen voor optimale prestaties.

Troubleshooting

Zie ook