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

Paketi Kurun

bash

dotnet add package Doconut.NET8

Sürüm belirtilmemiş 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.NET8 --version 26.7.0

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

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.

Kurulumu tamamlamak için iki ara katman (middleware) çağrısı gerekir ve sıraları önemlidir: UseDoconutResources() UseDoconut()'dan önce çalıştırılmalıdır. UseDoconut() terminal bir ara katmandır, bu yüzden onu önce çağırmak, /doconut-res varlığına yapılan her isteğin kaynak işleyicisine ulaşamamasına ve 404 hatası almasına neden olur. 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.AddSession(); // Doconut document security rides on ASP.NET session state

app.UseSession();          // call UseSession() before UseDoconut()
app.UseDoconutResources(); // must be registered before UseDoconut()
app.UseDoconut();

Tüm seçenekler

DoconutOptions aşağıdaki ayarlanabilir özellikleri kabul eder. Hepsi isteğe bağlıdır — bir özellik ayarlanmamışsa 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. Bir ön kontrol olarak faydalıdır; üretimde kapalı bırakın.
`UnsafeMode`	`false`	`true` olduğunda, sayfa isteklerinde ASP.NET-oturum güvenlik kontrolünü atlar. Üretimde kapalı bırakın.
`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ın sunulduğu yer.
`LicensePath`	`""` (empty string)	Lisans dosyasının yolu. Boş olduğunda bir sonraki kaynağa geçilir, ardından otomatik arama yapılır.
`LicenseContent`	`""` (empty string)	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 8 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, LicensePath'i ve otomatik aramayı geçer — bakınız Lisans Kurulumu.

csharp

builder.Services.AddDoconut(options =>
{
    options.LicensePath     = "Doconut.Viewer.lic";
    options.MiddlewarePath  = "/doconut";     // coordinate with app mapping and client BasePath
    options.ResourcesPath   = "/doconut-res"; // where the viewer's JS/CSS/images are served from
    options.UnsafeMode      = false;          // keep session security on
    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.