Birçok geliştirici, bir web uygulamasında belge görüntülemek gerektiğinde UI bileşen kütüphanelerine bakarak başlar. Doconut Viewer ASP.NET Core, MVC veya klasik WebForms projelerine eklenti‑gerektirmeyen tarayıcı görüntüleme eklemek için bir .NET SDK'sıdır. Güvenlik hâlâ tam uygulama mimarisine bağlıdır: kimlik doğrulama, yetkilendirme, taşıma, depolama, doğrulama, temizlik, yama ve izleme.
1. Doconut App SDK'sını Yükleyin ve .NET Projenizi Çoklu Dosya Formatları İçin Hazırlayın
1.1 Desteklenen paketi ekleyin
Resmi Doconut indirme sayfasından mevcut paketi ve kurulum talimatlarını kullanın. Seçilen sürümü kaydedin ve hedef .NET çalışma zamanını desteklediğini doğrulayın.
1.2 Paket referansını doğrulayın
Kurulumdan sonra, proje dosyasında paket referansını ve çözülen sürümü doğrulayın. Sürümleri açık tutmak, derlemelerin ve dağıtımların tekrarlanabilir olmasına yardımcı olur.
1.3 HTTPS'yi Etkinleştirin
Doconut App tüm dosya yüklemeleri için SSL gerektirir. Uygulamanızın HTTPS üzerinden dinlediğinden emin olun. Kestrel‑hostlu bir uygulama için, appsettings.json içinde bir uç nokta yapılandırması ekleyin:
{
"Kestrel": {
"Endpoints": {
"Https": {
"Url": "
}
}
}
}
IIS üzerinde barındırıyorsanız, siteye bir HTTPS sertifikası bağlayın. HTTPS etkinleştirildiğinde, her dosya Doconut App’in render motoruna ulaşmadan önce güvenli bir kanal üzerinden iletilir.
Neden Doconut App? Doconut App, sıfır‑eklenti renderlamayı uç‑uç AES‑256 şifreleme ile birleştiren tek .NET‑yerel görüntüleyicidir; ek altyapı eklemeden uyumluluk gereksinimlerini karşılamanızı sağlar.
2. Belge Yönetimi için Güvenli Dosya Yüklemeleri ve Depolamayı Yapılandırın
Doconut App’in güvenlik modeli üç temel üzerine kuruludur: SSL taşıma, dinlenirken AES‑256 şifreleme ve görüntülemeden sonra otomatik silme. SDK, uygulamanıza kaydedebileceğiniz hazır bir hizmet sunar.
2.1 Yükleme hizmetini kaydedin
Startup.cs içinde (veya .NET 6+ için Program.cs içinde), Doconut hizmetlerini bağımlılık enjeksiyon konteynerine ekleyin. Geçici bir depolama klasörü yapılandırın, AES‑256 şifrelemeyi etkinleştirin ve otomatik silme aralığını ayarlayın (örneğin, belge görüntülendikten 10 dakika sonra).
2.2 Yükleme uç noktasını oluşturun
Yüklenen bir dosyayı alan, Doconut hizmetine güvenli depolama için ileten ve kısa bir tek‑kullanımlık token döndüren bir denetleyici eylemi uygulayın. Bu token, istemci‑tarafı görüntüleyicinin belgeyi alıp render etmesi için kullanılır.
2.3 Uç noktayı koruyun
Yükleme uç noktası hassas verilerle ilgilendiği için, kimlik doğrulama ve rol‑tabanlı yetkilendirme ile koruyun (örneğin, sadece DocumentViewer rolündeki kullanıcılar yükleme yapabilir). Bu, yalnızca yetkili personelin gizli belgeleri depolayıp görüntüleyebilmesini sağlar.
Doconut App avantajı: SDK şifreleme ve temizlik işlemlerini sizin için yönetir, böylece özel kriptografi kodu yazmak ya da sahipsiz dosyalarla uğraşmak zorunda kalmazsınız.
3. Viewer Bileşenini ASP.NET Core, MVC veya WebForms içinde Yerleştirin
Arka uç hazır olduğunda, yüklü Doconut sürümü için belgelenen varlıklar ve API kullanarak görüntüleyiciyi başlatın.
3.1 JavaScript paketini ekleyin
Paylaşılan düzeninizde, yüklü SDK ile eşleşen belgelerde tanımlanan yalnızca görüntüleyici kaynaklarını dahil edin. Sürümler arasında sabit paket adları veya konumları varsaymayın.
3.2 Core/MVC için bir Razor görünümü oluşturun
Views/Document/View.cshtml gibi bir görünüm ekleyin; bu görünüm bir dosya girişi, görüntüleyici için bir konteyner öğesi ve seçilen dosyayı yükleyen, güvenli tokenı alan ve Doconut Viewer widget'ını başlatan küçük bir script içerir.
Script şu adımları izlemelidir:
- Seçilen dosyayı
<input type="file">öğesinden yakalayın. - Dosyayı
fetchveyaXMLHttpRequestkullanarak yükleme uç noktasına gönderin. - Yetkili yanıt geldiğinde, yüklü sürüm için desteklenen API'yi kullanarak görüntüleyiciyi başlatın.
3.3 WebForms eşdeğeri
Bir WebForms sayfasında (örneğin DocumentViewer.aspx), bir asp:FileUpload kontrolü, yüklemeyi tetikleyen bir düğme ve görüntüleyiciyi barındıracak bir <div> yerleştirin. Kod‑arkasında, Doconut hizmetini çağırarak yüklenen dosyayı depolayın, tokenı alın ve görüntüleyici örneğini oluşturmak için bir JavaScript fonksiyonunu (initViewer(token)) çağıran bir başlangıç scripti kaydedin.
Doconut App faydası: Tek bir JavaScript widget'ı, üç .NET UI modeli, ekstra kütüphane yok. En iyi sadelik.
4. Viewer'ı Belge Yönetimi için Özelleştirin
Kutudan çıktığı haliyle, Doconut Viewer temiz bir araç çubuğu, yakınlaştırma kontrolleri ve aydınlık/karanlık tema geçişi sunar. UI'yi markanıza uyacak ve belirli belge türlerine göre özelleştirebilirsiniz.
4.1 Araç çubuğu yapılandırması
Görüntüleyiciyi başlatırken, hangi araç çubuğu öğelerinin görünür olacağını belirtebilirsiniz (örneğin, download, print, zoomIn, zoomOut, fullScreen). Örneğin download düğmesini kaldırmak, kullanıcıların orijinal dosyayı kaydetmesini engeller.
4.2 Tema ve renkler
theme seçeneğini 'dark' veya 'light' olarak ayarlayın ve isteğe bağlı olarak kurumsal paletinize uyan bir primaryColor sağlayın. Viewer, CSS değişkenlerine saygı gösterir; böylece özel bir stil sayfası ile daha derin stil vermeniz mümkün olur.
4.3 CAD‑özel araçlar
DWG, DXF veya DGN dosyaları gösteriyorsanız, CAD seçenekleri enableMeasurement ve enableLayerToggle'ı etkinleştirin. Bu, ölçüm, açı ve alan araçlarını ve araç çubuğunda doğrudan bir katman‑görünürlük paneli ekler.
4.4 Yerelleştirme
Başlatma sırasında bir locale kodu (örneğin, Fransızca için 'fr') geçirin. Tüm UI metinleri, araç ipuçları ve hata mesajları seçilen dilde gösterilir.
Neden özelleştirilir? Doconut App, aynı güvenli, eklenti‑gerektirmeyen deneyimi sunarken, görüntüleyicinin sitenizin doğal bir uzantısı gibi görünmesini sağlar.
5. Entegrasyonu Tüm Desteklenen Formatlarda Test Edin
Canlıya geçmeden önce, kullanıcılarınızın görüntülemesini beklediğiniz her dosya türü için hızlı bir kontrol çalıştırın. Doconut App’in görüntüleyicisini kullanarak, her formatın örnek dosyasını açın ve render, gezinme ve özel araçların açıklandığı gibi çalıştığını doğrulayın.
| Format | Test Senaryosu | Beklenen Sonuç |
|---|---|---|
| Gömülü görüntüler içeren büyük, çok sayfalı rapor | Yumuşak kaydırma, yakınlaştırma ve doğru renk render'ı | |
| DOCX | Tablolar ve dipnotlar içeren Word belgesi | Tüm metin, tablolar ve dipnotlar görünür; düzen kayması yok |
| XLSX | Grafikler içeren elektronik tablo | Grafikler vektör grafik olarak render edilir; yakınlaştırma netliği korur |
| PPTX | Statik ön izleme içeren slayt paketi | İlk slayt doğru gösterilir; bozuk varlık yok |
| DWG | Birden fazla katmana sahip teknik çizim | Katman geçişi, ölçümler çalışır, çizgiler net kalır |
| PSD | Katmanlı Photoshop dosyası | Katmanlar görünür, renkler tam, yakınlaştırma keskin kalır |
| SVG | Gradyanlı vektör grafik | Gradyanlar sorunsuz render edilir; yakınlaştırma keskin kalır |
| TIFF | Yüksek çözünürlüklü tarama | Görüntü hızlı yüklenir; yakınlaştırma detayları gösterir |
Bu kontrol listesini Doconut App ile çalıştırmak, her desteklenen formatın kullanıcılarınız için güvenilir bir şekilde çalışmasını sağlar.
Sonuç
Güvenli, eklenti‑gerektirmeyen bir belge görüntüleyiciyi yerleştirmek artık Doconut App ile oldukça basit. Yukarıdaki adımları—SDK'yı kurmak, şifreli yüklemeleri yapılandırmak, hafif JavaScript widget'ını gömmek ve UI'ı özelleştirmek—takip ederek, ASP.NET Core, MVC ve WebForms uygulamaları içinde hızlı ve yüksek‑kaliteli belge render'ı sunabilirsiniz.
Değerlendirmeye hazır mısınız? Resmi Doconut indirme ve dokümantasyon sayfası ile başlayın, ardından SDK'yı Windows tabanlı ASP.NET uygulamanızın geri kalanına uyguladığınız aynı güvenlik incelemesi içinde test edin.