Base Doconut görüntüleyicisi .NET 6 için tek bir NuGet paketi olarak gelir ve herhangi bir ASP.NET Core uygulamasına bağlanır. İsteğe bağlı eklentiler ayrı paketler kullanır. Bu sayfa temel paketi kurar ve ara katmanı (middleware) kaydeder — ilk render işleminizden önce gereken minimum şey.

Paketi kurun

bash

dotnet add package Doconut.NET6

Versiyonsuz komut en son kararlı sürümü kurar. Mevcut 26.7.0 sürümünü tam olarak yeniden oluşturmak için sürümü ayrı bir seçenek olarak geçirin:

bash

dotnet add package Doconut.NET6 --version 26.7.0

Doconut.NET6 paket kimliğidir. .26.7.0 son eki, indirilen Doconut.NET6.26.7.0.nupkg dosya adının bir parçasıdır ve kimliğin bir parçası değildir.

Yükseltmeden önce entegrasyonu belirleyin

Doconut.NET6 paket kimliği hem klasik hem de mevcut .NET 6 entegrasyonları tarafından kullanılmıştır. Sadece paket adından belge seçmeyin:

DocImage.axd, new Viewer(_cache, _accessor, ...), eşzamanlı OpenDocument(...) ve manuel olarak kopyalanmış görüntüleyici betikleri, klasik entegrasyon olarak tanımlar;
AddDoconut(), UseDoconutResources(), enjekte edilmiş bir Viewer ve OpenDocumentAsync(...) mevcut entegrasyonu burada belgeler.

Çevrilmiş klasik kurulum kılavuzu hâlâ kullanılabilir. Nesilleri değiştirmek için göç rehberi kullanın; normal bir paket güncellemesi başlangıç, görüntüleyici ömrü veya tarayıcı kaynaklarını otomatik olarak dönüştürmez.

Doconut'u Kaydedin

AddDoconut() tek kayıt giriş noktasıdır — tek bir aşırı yükleme vardır ve Viewer hizmetini, lisans hizmetini ve render altyapısını DI konteynerine bağlar.

İki ara katman çağrısı kurulumu tamamlar ve sıraları önemlidir: UseDoconutResources() UseDoconut()'dan önce çalışmalıdır. UseDoconut() sonlandırıcı ara katmandır, bu yüzden önce çağrılırsa /doconut-res varlığına yapılan her istek kaynak işleyicisine ulaşamaz ve 404 döner. Oturum bağlaması da gereklidir — Doconut'un varsayılan belge güvenliği her sayfa isteğini ASP.NET oturum durumuna karşı doğrular.

csharp

builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddDistributedMemoryCache(); // oturum durumu bir önbelleğe ihtiyaç duyar (MVC/Razor Pages zaten bir tane ekler)
builder.Services.AddSession(); // Doconut belge güvenliği ASP.NET oturum durumu üzerine kuruludur

app.UseSession();          // UseSession()'i UseDoconut()'dan önce çağırın
app.UseDoconutResources(); // UseDoconut()'dan önce kaydedilmelidir
app.UseDoconut();

Tüm seçenekler

DoconutOptions aşağıdaki ayarlanabilir özellikleri kabul eder. Hepsi isteğe bağlıdır — bir özellik boş bırakıldığında aşağıdaki varsayılanlar uygulanır.

Özellik	Varsayılan	Açıklama
`ShowDoconutInfo`	`false`	`true` olduğunda, `token` içermeyen bir istek 404 yerine bir sürüm bannerı döndürür. Hızlı bir kontrol için faydalıdır; üretimde kapalı tutun.
`UnsafeMode`	`false`	`true` olduğunda, sayfa isteklerinde ASP.NET-oturum güvenlik kontrolü atlanır. Üretimde kapalı tutun.
`MiddlewarePath`	`"/doconut"`	Sayfa‑görsel uç noktası için koordinasyon değeri. Doğrulanır, ancak tek başına bir dal oluşturmaz; gerçek `UseDoconut()` eşlemesi ve istemci `BasePath` ile uyumlu tutun.
`ResourcesPath`	`"/doconut-res"`	Gömülü JS/CSS/görsel kaynakların hizmet verildiği yer.
`LicensePath`	`""` (boş dize)	Lisans dosyasının yolu. Boş ise bir sonraki kaynağa geçilir, ardından otomatik arama yapılır.
`LicenseContent`	`""` (boş dize)	Ham lisans içeriği — bir ortam değişkeni, gizli yönetici veya veritabanından.
`LicenseStream`	`null`	Başlangıçta bir kez okunan akış olarak lisans.
`ResetLicense`	`false`	Ayrılmış uyumluluk bayrağı. Mevcut .NET 6 hizmetleri lisansı `AddDoconut()` sırasında okur; bir lisans değiştirildikten sonra uygulamayı yeniden başlatın.

Birden fazla kaynak ayarlandığında lisans önceliği: LicenseStream LicenseContent'i, LicenseContent LicensePath'i, LicensePath otomatik aramayı geçer — bakınız Lisans Kurulumu.

csharp

builder.Services.AddDoconut(options =>
{
    options.LicensePath     = "Doconut.Viewer.lic";
    options.MiddlewarePath  = "/doconut";     // uygulama eşlemesi ve istemci BasePath'iyle koordine edin
    options.ResourcesPath   = "/doconut-res"; // görüntüleyicinin JS/CSS/görsellerinin hizmet verildiği yer
    options.UnsafeMode      = false;          // oturum güvenliğini açık tut
    options.ShowDoconutInfo = false;
});

Sonraki adımlar

Hızlı Başlangıç — ilk belgenizi açın ve tarayıcıda render edin.
Lisans Kurulumu — Doconut'un lisans dosyanızı nerede aradığını gösterir.