Sorun Giderme

Yaygın hataları teşhis edin

Birçok System.Web hatası, görebileceğiniz bir istisna üretmez: sayfa boş bir 500 yanıt verir, bir simge 404 döner veya bir istek hiç dönmez. Bu sayfa, gözlemlediklerinize göre düzenlenmiştir. Alıntılanan mesajlar, Doconut'un ürettiği tam metindir.

Belirtiler bir bakışta

Gördüğünüz şeyEn muhtemel nedenDüzeltme
Her istek boş bir 500 yanıt verirApplication_Start içinde bir istisna: lisansı olmayan bir eklenti, geçersiz bir seçenek, eksik bir farm yapılandırması — ya da bin\ içinde olmayan bir sürümü adlandıran bir binding yönlendirmesiWindows olay günlüğü, Application, kaynak ASP.NET. Bkz. Başlangıç hataları
Bazı MVC sayfaları boş bir 500 yanıt verirRazor, görünümleri çalışma zamanında derler: netstandard dış görünüşü <compilation> içinde eksik, ya da görünüm C# 5'ten yeni bir sürüm kullanıyor (?., $"...", nameof)Dış görünüşü ekleyin (Kurulum); mantığı görünüştan kontrolcüye taşıyın
Sayfalar tire ve aksanlar yerine —, … veya benzeri gösterirByte-order markı olmayan sayfa dosyaları, sunucunun ANSI kod sayfası ile okunur<globalization fileEncoding="utf-8" requestEncoding="utf-8" responseEncoding="utf-8" />
Tarayıcı konsolu HEAD /DocImage.axd?...&page=1 için 404 gösterirİşleyici, HEAD fiili olmadan kaydedilmişverb="GET,HEAD,POST" işleyicide
Belge renderlanıyor, ancak araç çubuğu simgeleri ve yükleme döndürücüsü eksikResPath kaynak köküne işaret ediyor, ya da / ile başlıyorResPath: 'doconut-res/images'
/doconut-res/... istekleri 404 yanıt verirKaynak modülü kaydedilmemiş, runAllManagedModulesForAllRequests kapalı, ya da MVC yönlendirmesi yolu yakalar<modules> girişi ve routes.IgnoreRoute("doconut-res/{*pathInfo}")
Görüntüleyici The viewer handler could not be reached (no response). rapor ederBasePath / ile başlar ('/myapp', başka bir host, //myapp/… olur)BasePath: '/' site kökünde; 'myapp' sanal dizinde
Görüntüleyici Please make sure your middleware is configured. rapor ederDocImage.axd, 404 yanıtladı: işleyici Web.config içinde değil, MVC yönlendirmesi yakaladı, ya da BasePath başka bir yere işaret ediyor<handlers> girişi, routes.IgnoreRoute("{resource}.axd/{*pathInfo}") ve BasePath
Her sayfa You Are Not Authorized To View This Page. gösterirBelge, oturum durumu olmayan bir istekte açıldı, oturum durumu kapalı, ya da oturum çerezi DocImage.axd'a ulaşmıyorBkz. Yetkilendirilmemiş
Web Forms dönüşümü hiç dönmezSayfa ConvertAsync üzerinde bloklanır — bir deadlockAsync="true" + RegisterAsyncTask (Dönüştürücü Eklentisi)
Her sayfa bir değerlendirme filigranı taşırLisans bulunamadı — <site root>\wwwroot içinde değilLisans Kurulumu
Bir widget yüklenir, ancak ilk eylemi 404 yanıt verirWidget etkin değil, ya da basePath '/DocImage.axd' değiloptions.Add…Widget(), ve basePath: '/DocImage.axd'
Site başlatıldıktan veya yeniden döndürülmeden sonraki ilk belge bir dakika ya da daha uzun sürer; sonraki belgeler hızlıdırBelge motorları ilk açılışta yüklenir ve gerçek zamanlı antivirüs onları yüklenirken tararSiteyi ısıtın ve havuzu çalışır tutun — Bkz. Başlangıçtan sonraki ilk belge
Büyük bir yükleme IIS hata sayfası gösterirYükleme maxRequestLength (KB) veya maxAllowedContentLength (bayt) değerini aşıyorİkisini de en büyük dosyanızın veya widget sınırınızın üzerine çıkarın

Başlangıç hataları

Application_Start içinde atılan bir istisna tarayıcıya ulaşmaz: her istek boş bir 500 yanıt verir ve IIS günlüğü faydalı bir şey göstermez. İstisna Windows olay günlüğünde (Event Viewer → Windows Logs → Application, source ASP.NET) bulunur. Yaygın olanlar:

Lisansı olmayan bir eklenti:

text
The Converter plugin is registered via AddPlugin but no active license grants Converter.
Remove the AddPlugin<...>() call or install a license (or trial/demo) that includes Converter.

Eklentinin Doconut.Viewer.<Capability>.lic, wwwroot içinde, Doconut.Viewer.lic yanına konulmalıdır. Eksik bir lisans ve eski bir TRIAL dosyası, eklenti yetenekleri sağlamaz.

Geçersiz seçenekler:

text
DoconutOptions.MiddlewarePath must be a non-empty path starting with '/'.
DoconutOptions.ResourcesPath must be a non-empty path starting with '/'.
DoconutOptions.MiddlewarePath and ResourcesPath must be different paths.

Yüklenemeyen bir derleme. ASP.NET, uygulama başladığında bin\ içindeki her derlemeyi yükler, bu yüzden bin\ içinde bulunmayan bir sürümü adlandıran Web.config içindeki bir binding yönlendirmesi tüm siteyi durdurur. Yönlendirmeleri elle düzenlemek yerine, NuGet'in (SDK tarzı bir proje için, bin\<YourApp>.dll.config'dan) oluşturduğu yönlendirmeleri kopyalayın ve paket güncellemelerinden sonra tekrar kopyalayın.

Bu Sayfayı Görüntüleme Yetkiniz Yok.

Sayfa, istekte bulunan ASP.NET oturumunun belgeye hiç izin vermediği için reddedildi. Sırayla kontrol edin:

  1. Açma oturum durumu ile çalıştı. MVC denetleyicileri ve Web Forms sayfaları bunu içerir. Belgeleri açan özel IHttpHandler, System.Web.SessionState.IRequiresSessionState uygulamalıdır, aksi takdirde oturum vermez.
  2. Oturum durumu açık. <sessionState mode="Off" /> her sayfayı reddeder.
  3. Çerez işleyiciye ulaşır. Widget'ın aynı kökenli istekleri ASP.NET_SessionId taşır; bir betik, sunucu‑sunucu çağrısı veya çerez içermeyen çapraz‑kökenli bir sayfa bunu yapmaz.
  4. Web çiftliği: açma tarayıcıyı (DocOptions.BrowserId) bağlar ve sayfa bileti (objViewer.View(token, access)) iletir; her düğüm aynı imzalama anahtarını kullanır.

Reddetme, durum 200 ile sunulan yaklaşık 2 KB'lık bir görüntüdür. Yalnızca durum kodlarını kontrol eden bir izleyici bunu bir sayfa olarak sayar.

Belge oturumu bulunamadı. Lütfen belgeyi yeniden açın.

Token süresi doldu (kaydırmalı pencere, DocOptions.TimeOut, varsayılan 60 dakika), belge kapatıldı veya — tek bir sunucuda — uygulama havuzu yeniden başlatıldı. Yeniden başlatma zamanlanmış olarak, her Web.config düzenlemesinde ve havuzun boşta kalma zaman aşımından (IIS'te varsayılan 20 dakika) sonra gerçekleşir. Yeni bir token için belgeyi tekrar açın.

Belge açma başarısız

LicenseException bir reddetme nedeni ile — lisans dosyası bulundu ancak reddedildi (geçersiz imza, müdahale, kara listeye ekleme veya lisansın sürüm penceresinin dışındaki bir yapı). Açma, filigran eklemek yerine engellenir.

LicenseException:

text
This document type requires the 'Dicom' plugin license.

Uzantı yalnızca bir eklenti (burada DICOM) tarafından işlenir. Eklenti kaydedildi, ancak artık hiçbir lisans yeteneğini vermiyor — genellikle sitenin başlatılmasından sonra süresi dolmuş bir Geçici lisans. Yetki veren bir lisans kurun.

FormatNotSupportedException — uzantıyı talep eden bir görüntüleyici (yerleşik, eklenti veya özel) yok. DoconutOptions.RegisterViewer kendi formatlarınız için bir tane ekleyebilir.

InvalidDataException — içerik bozuk veya uzantısıyla eşleşmiyor (yeniden adlandırılmış dosya). Açmadan önce yüklemeleri doğrulayın.

InvalidOperationException:

text
No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>().

DocumentConverter, Converter eklentisi kaydedilmeden çözüldü.

Çıktı yanlış görünüyor

Sayfalar bir filigran taşır — lisans bulunamadı veya Geçici lisansın süresi doldu. Etkin bir Geçici lisans altında, yalnızca eklenti çıktısı filigranlıdır. Bu sürümü kapsamayan bir lisans filigran eklemez: açma LicenseException hatası verir. IIS altında, lisans site kökünün (AppContext.BaseDirectory\wwwroot) altında wwwroot içinde olmalı, bin\ içinde değil. IDoconutLicenseService kontrol edin (License.IsLicenseFileFound, IsExpired, IsVersionValid, License.RejectionMessage).

Eski belgeler bozuk metin gösterir — kod sayfası kodlamalarını bir kez, başlangıçta kaydedin:

csharp
// Global.asax.cs, Application_Start - DoconutHost.Initialize öncesinde.
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

Yanlış veya yerine konmuş yazı tipleri — sunucuda belgenin yazı tipleri eksik. Office olmadan bir Windows Server, bir geliştirme makinesine göre çok daha az yazı tipine sahiptir. Yazı tiplerini kurun veya FontFolders (WordConfig ve PptConfig üzerinde) bu tipleri içeren bir klasöre yönlendirin.

Bir görüntü açıklaması görüntüleyicide görünür ancak dışa aktarımda "Image blocked" kutusu gösterir — görüntünün sunucusu özel veya döngüsel bir adrese sahiptir ve sunucu bunu almaya izin vermez. Bakınız Açıklamalar.

Özellik değerlendirmede çalıştı, üretimde sessiz

Bir etkin Geçici lisans tüm yetenekleri verir; satın aldığınız lisans yalnızca satın aldıklarınızı verir. Bir yetenek olmadan, arama veya açıklama dosyaları üretilmez ve kayıtlı bir eklenti siteyi başlangıçta durdurur. Dağıtmadan önce kullandığınız her özellik ile IsCapabilityGranted(...) karşılaştırın.

Arama hiçbir şey bulamıyor (veya çok az)

  • PDF için, belge açıldığında AllowSearch etkinleştirilmemişti — varsayılan olarak false kullanılır. Word, Excel ve PowerPoint aynı anahtarı sunar.
  • İçerik taranmış veya yalnızca görüntü olduğu için eşleşecek bir metin katmanı yok.
  • HTML ve Microsoft Project (MPP) varsayılan ayarlarında aranabilir değildir: DefaultRender = false ayarlayın ki metin içeren bir PDF projeksiyonu üzerinden renderlensin.
  • objViewer.CanSearch(), başlatmadan sonra false durumundadır: çözülen formatın arama yolu yoktur. Bu, Arama lisansından ayrı bir durumdur; ikisini de kontrol edin.
  • Sayfa, objViewer.Search(...)'in dönüş değerini okur — sayı, üçüncü argümanında, bir geri çağrıda gelir.

Hâlâ takıldı mı?

Sorunu, Hızlı Başlangıç içindeki minimal kurulumla yeniden üretin. Orada da tekrarlanıyorsa, belge, Global.asax.cs, Doconut parçaları olan Web.config ve varsa Windows olay günlüğü girdisi ile destek birimine başvurun.

Bu sayfa yardımcı oldu mu?