Blazor size bir bileşen modeli ve üçüncü taraf JavaScript'lere pek önem vermeyen bir render döngüsü sunar. Doconut buna karşı değil, onunla birlikte çalışır: renderleme kendi sürecinizde sunucu tarafında gerçekleşir ve widget, normal interop yaşam döngüsü aracılığıyla kontrol ettiğiniz basit bir öğeye monte edilir.
Sorun
İstemci tarafı yolu, bir render motorunu tarayıcıya gönderme anlamına gelir. Blazor WebAssembly'de bu doğrudan indirme boyutunuza yansır ve yalnızca PDF'yi kapsar — birisi DOCX veya XLSX yüklediği anda tekrar başa dönersiniz.
iframe-to-Office yolu, belgelerinizin başkasının altyapısı üzerinden geçmesi demektir; bu da muhtemelen iki kez yapmak istemeyeceğiniz bir güvenlik ekibiyle konuşma anlamına gelir.
Doconut üçüncü yolu seçer. Dosya, kendi sunucunuz tarafından sayfa görüntülerine rasterleştirilir ve Blazor sadece bir div barındırmak zorundadır. Bileşen ağacınız asla sahip olmadığı bir görüntüleyiciyi yeniden render etmez ve diff motorunun mücadele edecek bir şeyi olmaz.
Yetenekler
Renderleme her iki durumda da sunucu tarafındadır. Server'da çağrı doğrudan yapılır; WebAssembly'de açma çağrısını minimal bir API uç noktası olarak ortaya çıkarır ve dönen token'ı widget'a verirsiniz. İkisi de birkaç satır kod gerektirir.
Widget'ı bir kez, ilk render'dan sonra, standart JS interop kancasıyla başlatın. Blazor, görüntüleyicinin iç DOM'unun sahibi olmadığı için sonraki render'lar ona dokunmaz.
Interactive Server, Interactive WebAssembly veya Auto. Görüntüleyici, bileşen durumu yerine opak bir token ile yönlendirilir, bu yüzden render modunu değiştirmek entegrasyonu etkilemez.
Aynı bileşen PDF, DOCX, XLSX, PPTX, DWG, MSG ve katalogdaki diğerlerini açar. Her dosya ailesi için ayrı bir sayfa değil, tek bir görüntüleyici sayfası yazarsınız.
Navigasyon UI'si widget ile birlikte gelir. Bir canvas ve sayfa numarası girişiyle bir görüntüleyici inşa etmiyorsunuz, sadece bir görüntüleyici bağlarsınız.
Renderlenen sayfa görüntüleri dışında tarayıcıya hiçbir şey akıtılmaz, bu WebAssembly'de beklenenden daha önemlidir — sonuçta istemci tamamen incelenebilir.
Entegrasyon
doconutHost.mount, $('#div_ctlDoc').docViewer({ ... }) çağıran ve ardından .View(token) yapan kendi JavaScript kodunuzun birkaç satırıdır. Bunu Blazor dışına tutmak kasıtlıdır — widget'ın DOM'u renderlayıcının uzlaştırmaya çalışması gereken bir şey olmamalıdır.
Desteklenen platformlar
// Program.cs — order matters
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddSession();
app.UseSession(); // before UseDoconut()
app.UseDoconutResources(); // before UseDoconut()
app.UseDoconut();
// Viewer.razor — open server-side, hand the token to the widget
@inject Doconut.Viewer Viewer
@inject IJSRuntime JS
<div id="divDocViewer"><div id="div_ctlDoc"></div></div>
@code {
protected override async Task OnAfterRenderAsync(bool firstRender)
{
if (!firstRender) return;
// Authorize first — the viewer renders whatever you hand it.
string token = await Viewer.OpenDocumentAsync("wwwroot/files/Sample.pdf");
await JS.InvokeVoidAsync("doconutHost.mount", token);
}
}Detaylar
Her ikisi de. Renderleme her zaman sunucu tarafında gerçekleşir, bu yüzden WebAssembly'de OpenDocumentAsync'i çağıran bir uç nokta ekleyip token'ı döndürürsünüz. İstemci asla bir belge ayrıştırmaz, bu da WASM yükünün etkilenmemesinin tam nedenidir.
Hayır, Blazor'un bir yaprak olarak gördüğü bir öğeye monte ettiğiniz sürece. Boş bir div render edin ve widget'ın interop aracılığıyla doldurmasına izin verin — diff motorunun uzlaştıracak çocuğu olmaz.
Hayır. Tek bir sayfa tüm katalogu yönetir. Format, önceden seçtiğiniz değil, açtığınız belgeden algılanır.
ASP.NET Core
Normal DI ve ara katman olarak kaydeder. Zaten sahip olduğunuz kimlik doğrulama, kayıt ve barındırmayı devralır.
ASP.NET CoreSunucu tarafı PDF oluşturma, sayfa görüntülerine — kullanıcı belgeyi hiç dosyayı almadan okur.
PDFGeçici bir lisansın talep edilmesi birkaç dakika sürer ve tamamen kendi bilgisayarınızda çalışır. Önemli dosyalar, mevcut görüntüleyicinizi zaten bozmakta olan dosyalardır.