Sorun Giderme
Aspose.PDF FOSS for .NET ile çalışırken yaygın sorunlar ve çözümler.
Belge Yükleme
| Sorun | Neden | Çözüm |
|---|
Document.Open geçerli bir PDF’de hata veriyor | Dosya şifre korumalı | Şifreyi yapıcıda sağlayın |
| Büyük PDF’lerde bellek yetersizliği | Tüm dosya bayt dizisine yüklendi | Sayfaları tek tek işleyin veya streaming kullanın |
Pages[0] indeks hatası fırlatıyor | Sayfalar 1 tabanlı indeksleme kullanıyor | İlk sayfa için Pages[1] kullanın |
Açıklamalar
| Sorun | Neden | Çözüm |
|---|
| Kaydetmeden sonra açıklama görünmüyor | Dikdörtgenin alanı sıfırdır veya sayfa sınırlarının dışındadır | Koordinatların sayfa içinde olduğundan emin olun MediaBox |
LinkAnnotation.Uri null döndürür | Bağlantı GoTo veya JavaScript eylemi kullanıyor | PdfAction.Create aracılığıyla çözün ve ActionType kontrol edin |
Flatten() hata veriyor | Açıklama eksik /P (sayfa) referansı | Açıklamanın Page.Annotations aracılığıyla eklendiğinden emin olun |
Metin Çıkarma
| Sorun | Neden | Çözüm |
|---|
| Çıkarılan metin bozuk | Standart dışı kodlama veya CID yazı tipi eşlemesi | Yazı tipi gömülmesini kontrol edin; taranmış PDF’ler OCR gerektirebilir |
| Metin parçacığı bulunamadı | Sayfa içeriği raster görüntüsü | Metin çıkarımından önce OCR kullanın |
| Regex eşleşme döndürmüyor | PDF metin düzeni boşluk ekliyor | Daha gevşek bir desen kullanın veya boşlukları normalleştirin |
Renderleme ve Dönüştürme
| Sorun | Neden | Çözüm |
|---|
| Oluşturulan görüntü bulanık | Çözünürlük çok düşük | Resolution yapıcısında DPI’yi artırın |
| HTML çıktısında resimler eksik | Harici resim yolları yapılandırılmadı | Gömülü resimlerle HtmlSaveOptions kullanın |
| PDF/A dönüşümü ek açıklamaları kaldırıyor | Hedef profil ek açıklamalara izin vermiyor | PDF/A-2 veya PDF/A-3 kullanın |
Form Alanları
| Sorun | Neden | Çözüm |
|---|
| Alan değeri boş | Alan, /V girişine sahip değil | field.Value null olmadığını kontrol edin |
FillField etkisiz | Alan adı eşleşmiyor | Mevcut adları listelemek için Form.FieldNames kullanın |
| ExportToJson boş çıktı üretiyor | Widget açıklaması doğru şekilde dönüştürülmemiş | Açıklamanın bir WidgetAnnotation olduğunu doğrulayın |
Genel İpuçları
- Dosya tutamaçlarını serbest bırakmak için her zaman
Document‘yi using içinde sarın. - Dosya kilitlenmelerini önlemek için bellek içi iş akışları için
Document.Open(byte[]) kullanın. - Sayfalara indeksle erişmeden önce
doc.Pages.Count‘yi kontrol edin. - En iyi performans için tüm değişikliklerden sonra belgeyi bir kez kaydedin.
Ayrıca Bakınız