.NET uygulamanız içinde çalışan kendi‑sunucuda, yıldırım‑hızında bir belge görüntüleyiciniz olacak
Bu kılavuzun sonunda, PDF, Office dosyaları, CAD çizimleri ve onlarca diğer formatı doğrudan tarayıcıda açabilir, saniyenin altında yükleme süreleri, harici SaaS çağrıları olmadan ve güvenlik üzerinde tam kontrol elde edebilirsiniz.
Gereksinimler
| Ne gerekir | Neden önemlidir |
|---|---|
| .NET 6 veya üzeri (SDK .NET 6+ hedefler) | Online Document Viewer SDK ile uyumluluğu garanti eder |
| Uygulamanızı çalıştırabileceğiniz bir Windows veya Linux sunucu (yerinde veya özel bulut) | Kendi‑sunucuda barındırma, görüntüleyicinin kendi altyapınız içinde çalışmasını gerektirir |
| Online Document Viewer NuGet kaynağına erişim (https://doconut.com) | SDK bir NuGet paketi olarak dağıtılır |
| ASP.NET Core ve ön‑uç JavaScript hakkında temel bilgi | İmzalı bir URL döndüren bir uç nokta açacak ve ardından görüntüleyiciyi tarayıcıdan başlatacaksınız |
| Kaynak dosyalar için bir depolama konumu (dosya sistemi, blob depolama vb.) | Görüntüleyici dosyaları yerel ya da ağ yolundan render eder; kaynak, sunucu süreci tarafından erişilebilir olmalıdır |
Bu öğelerden herhangi biri eksik olursa, kodun ilk satırı çalışmadan önce derleme durur.
Online Document Viewer SDK’yı Kurun
Çözümünüzü Visual Studio’da ya da tercih ettiğiniz IDE’de açın ve resmi SDK’yı NuGet yöneticisi aracılığıyla ekleyin:
dotnet add package Doconut.NET8
Paket, render motoru, format dönüştürücüleri ve oluşturulan sayfaları sunan ince bir HTTP katmanı içerir. SDK uygulamanıza derlendiği için çalışma zamanında harici bir hizmetle iletişim kurulmaz.
Paket geri yüklendikten sonra, SDK hizmetlerini Program.cs (veya eski şablonlar için Startup.cs) içinde kaydedin. Kayıt, render boru hattını ASP.NET Core DI konteynerine enjekte eder ve kontrolcülerinizin kullanımına sunar.
Gereken formatlar için render boru hattını yapılandırın
Görüntüleyici kutudan çıktığı haliyle 50’den fazla formatı destekler, örneğin:
- PDF, DOC, DOCX, ODT, RTF
- XLS, XLSX, CSV, ODS
- PPT, PPTX, ODP
- DWG, DXF, DGN (CAD)
- PSD, SVG, TIFF, WEBP, ICO
- EML, MSG, EPUB, MOBI, MPP, VSD
Bir istek geldiğinde, SDK dosya tipini belirler ve uygun dönüştürücüyü seçer. En iyi performans için, render edilen sayfayı isteğin süresi boyunca bellekte saklayan yerleşik önbellekleme katmanını etkinleştirin; bu, “Yıldırım Hızlı – Optimize performans ve saniyenin altında yükleme ile anında belge renderı” deneyimini sağlar.
Kontrolcünüzde, SDK’nın render metodunu (ör. RenderAsync) çağırın ve kaynak dosyanın mutlak yolunu geçin. Metod, canvas tabanlı bir görüntüleyici içeren bir HTML parçacığı döndürür. Render sunucuda gerçekleştiği için istemci yalnızca görüntülenmeye hazır işaretlemeyi alır; bu da ağır istemci‑tarafı işlemeyi ortadan kaldırır.
Görüntüleyiciyi token‑tabanlı URL’ler ve isteğe bağlı kısıtlamalarla güvenceye alın
Veri egemenliği ve GDPR uyumu, kendi‑sunucuda dağıtımlar için yaygın endişelerdir. SDK, ASP.NET Core kimlik doğrulama sistemiyle bütünleşir ve belirli bir belgeye tek seferlik erişim sağlayan imzalı bir token oluşturmanıza olanak tanır.
Tipik akış:
- Ön‑uç, belge tanımlayıcısını sağlayarak API’nizden bir ön izleme tokenı ister.
- API’niz, kullanıcının izinlerini doğrular, dosya yolunu ve bir son tarih zaman damgasını kodlayan JWT‑stilinde bir token oluşturur ve tokenı döndürür.
- Ön‑uç, tokenı görüntüleyici URL’sine ekler (ör.
/viewer?token=…). SDK, her istekte tokenı doğrular ve değiştirilmiş ya da süresi dolmuş tokenları reddeder.
Kullanıcıların belgeyi indirmesini veya yazdırmasını önlemeniz gerekiyorsa, SDK’nın sağladığı render seçeneklerini yapılandırarak bu eylemleri devre dışı bırakın. Görüntüleyicinin JavaScript katmanı ardından indirme düğmesini gizleyecek, yazdırma kısayolunu bastıracak ve sağ‑tık bağlam menüsünü engelleyecektir.
Her şeyin çalıştığını doğrulayın
- Görüntüleyiciyi barındıran sayfaya gidin.
- Belge bir saniye içinde, kaydırma çubukları, yakınlaştırma kontrolleri ve bir arama kutusuyla görünmelidir.
- Eğer görüntüleyiciyi indirmeyi devre dışı bırakacak şekilde yapılandırdıysanız, “Download” düğmesi gizlenmiş olmalıdır.
- Belgeye sağ‑tıklamak, bu kısıtlama etkin olduğunda tarayıcı bağlam menüsünü açmamalıdır.
- Token süresi dolduktan sonra (varsayılan 5 dakika), sayfayı yenilemek “401 Unauthorized” hatası döndürmeli ve token doğrulamasının aktif olduğunu onaylamalıdır.
Bu kontrollerden biri başarısız olursa, ilgili adıma geri dönün: eksik SDK kaydı, hatalı token oluşturma veya atlanmış güvenlik bayrakları.