Resolució de problemes
Problemes comuns i solucions en treballar amb Aspose.PDF FOSS per a .NET.
Càrrega de document
| Problem | Cause | Solution |
|---|
Document.Open llança una excepció en un PDF vàlid | El fitxer està protegit amb contrasenya | Proporcioneu la contrasenya al constructor |
| Falta de memòria en PDFs grans | Tot el fitxer carregat en una matriu de bytes | Processa les pàgines individualment o utilitza streaming |
Pages[0] llança un error d’índex | Les pàgines utilitzen indexació basada en 1 | Utilitzeu Pages[1] per a la primera pàgina |
Anotacions
| Problema | Causa | Solució |
|---|
| L’anotació no és visible després de desar | El rectangle té àrea zero o està fora dels límits de la pàgina | Verifiqueu que les coordenades caiguin dins de la pàgina MediaBox |
LinkAnnotation.Uri retorna nul | L’enllaç utilitza una acció GoTo o JavaScript | Resolgueu mitjançant PdfAction.Create i comproveu ActionType |
Flatten() llança | Falta la referència d’anotació /P (pàgina) | Assegureu-vos que l’anotació s’hagi afegit mitjançant Page.Annotations |
Extracció de text
| Problema | Causa | Solució |
|---|
| El text extret és il·legible | Codificació no estàndard o mapatge de fonts CID | Comproveu la incrustació de fonts; els PDFs escanejats poden necessitar OCR |
| No s’han trobat fragments de text | El contingut de la pàgina és una imatge raster | Utilitzeu OCR abans d’extraure el text |
| L’expressió regular no retorna cap coincidència | El disseny del text del PDF insereix espais en blanc | Utilitzeu un patró més flexible o normalitzeu els espais en blanc |
Renderització i conversió
| Problem | Cause | Solution |
|---|
| La imatge renderitzada és borrosa | Resolució massa baixa | Incrementa el DPI al constructor Resolution |
| La sortida HTML manca imatges | Els camins d’imatges externs no estan configurats | Utilitza HtmlSaveOptions amb imatges incrustades |
| La conversió PDF/A elimina les anotacions | El perfil de destinació no permet anotacions | Utilitza PDF/A-2 o PDF/A-3 |
Camps de formulari
| Problema | Causa | Solució |
|---|
| El valor del camp és buit | El camp no té cap entrada /V | Comproveu que field.Value no sigui nul |
FillField no té cap efecte | Desajust del nom del camp | Utilitzeu Form.FieldNames per llistar els noms disponibles |
| ExportToJson produeix una sortida buida | L’anotació del widget no s’ha convertit correctament | Verifiqueu que l’anotació sigui una WidgetAnnotation |
Consells generals
- Sempre emboliqueu
Document dins de using per alliberar els identificadors de fitxer. - Utilitzeu
Document.Open(byte[]) per a fluxos de treball en memòria per evitar bloqueigs de fitxer. - Comproveu
doc.Pages.Count abans d’accedir a les pàgines per índex. - Deseu el document una sola vegada després de totes les modificacions per obtenir el millor rendiment.
Vegeu també