Görüntüleyici

Viewer (namespace Doconut) Razor sayfalarından, MVC denetleyicilerinden, Blazor bileşenlerinden veya minimal API'lerden belge açmak için genel giriş noktasını sağlar. sealed (mühürlenmiş) olup AddDoconut() ile transient (geçici) hizmet olarak kaydedilir ve yapıcı enjeksiyonu üzerinden çözülür — doğrudan oluşturulmaz.

Viewer istek başına durum tutmaz ve kasıtlı olarak IDisposable uygulamaz: belge oturumları oturum önbelleğinde bağımsız olarak yaşar, bu yüzden hizmeti yok etmek açık bir belgeyi asla kapatamaz (bkz. Core Concepts → Viewer Nasıl Çalışır).

OpenDocumentAsync

Bir belge açar ve istemci widget'ının sonraki tüm isteklerde kullandığı oturum jetonunu döndürür.

// Simple open
string token = await viewer.OpenDocumentAsync(path);

// With per-format config and options
token = await viewer.OpenDocumentAsync(
    path,
    new PdfConfig { AllowSearch = true, AllowCopy = true },
    new DocOptions { TimeOut = 30 });

// From an upload
await using var ms = new MemoryStream();
await file.CopyToAsync(ms);
ms.Position = 0;
token = await viewer.OpenDocumentAsync(ms, new FileInfo(file.FileName));

Ele alınması gereken istisnalar:

• LicenseException — bulunan bir lisans reddedilir (mesaj reddetme nedenini taşır) veya format artık sağlanmayan bir eklenti yeteneği gerektirir. Reddetme mesajı olmadan takvim süresi dolması, istisna fırlatmak yerine su işareti ekli rendera düşer.
• FormatNotSupportedException — Document format '<extension>' is not supported.
• InvalidDataException — dosya içeriği bozuk veya uzantısıyla eşleşmiyor.

CloseDocument

void CloseDocument(string token)

Oturumu önbellekten kaldırır (belge motorunu hemen yok eder), güvenlik işaretçisini siler ve erişim iznini iptal eder. İsteğe bağlı — kayma süresi aynı temizlik işlemini yapar — ancak büyük belgeler için önerilir.

GetPageCount

int GetPageCount(string token)

Açık oturumun toplam sayfa sayısını döndürür. Jeton bilinmiyorsa veya süresi dolmuşsa istisna fırlatır.

DocOptions

Açma başına, format bağımsız seçenekler (namespace Doconut):

Sınıf ayrıca normal tek‑host görüntüleme akışının dışına kasıtlı olarak konulmuş özel özellikler sunar:

Özel su işareti

DocOptions.Watermark altı tilde‑ayırıcı alana sahiptir. İsteğe bağlı baştaki ^ tüm köşelerde yerleşim talep eder:

^Text~Color~FontSize~FontName~Opacity~Angle

string token = await viewer.OpenDocumentAsync(
    path,
    new PdfConfig(),
    new DocOptions
    {
        Watermark = "^Confidential~Red~24~Verdana~80~-45",
        TimeOut = 30
    });

Ayrıştırıcı, isteğe bağlı ^ sonrası tam altı alan bekler. Geçersiz tanım, SDK'nın görünür Invalid Watermark geri dönüşüyle değiştirilir; sessizce kaybolmaz.

Lisans kararı

Aynı karar, sunulan sayfa görüntülerine ve açıklama dışa aktarımlarına da uygulanır. Animasyonlu GIF çıktısı kare‑kare damgalanır. Özel su işareti dolayısıyla lisanslı bir uygulama özelliğidir; değerlendirme su işaretini değiştirmek veya kaldırmak için kullanılmaz.

Açıklamalar API

Sunucu tarafı açıklama yükleme ve dışa aktarma. Tam kılavuz Guides → Annotations içinde bulunur; yüzey şu şekildedir:

DICOM meta verileri

Task<DicomMetadata?> GetDicomMetadataAsync(string token, CancellationToken ct = default)

Metod, API uyumluluğu için bulunur, ancak .NET 6 DICOM görüntüleyicisi teknik etiketleri sağlayamaz. DICOM ve DICOM olmayan oturumlar için null döner; bir DICOM oturumunda platform sınırlamasını açıklayan tek seferlik bir uyarı da yazar. Sayfa, kare ve animasyon renderı desteklenmeye devam eder.

Kaynak yardımcıları — ReferenceCss / ReferenceScripts

UseDoconutResources() tarafından sunulan gömülü kaynaklar için <link>/<script> etiketlerini doğru bağımlılık sırasıyla üretir. Arama ve açıklama gibi lisans‑kısıtlı özellikler yalnızca lisans bunları etkinleştirdiğinde emit edilir, böylece istemci UI'si sunucu davranışıyla tutarlı kalır.

string ReferenceCss(CssConfig? config = null)      // null → Bootstrap + viewer + search + annotation
string ReferenceScripts(ScriptConfig? config = null)

CssConfig bayrakları: IncludeBootstrapCss, IncludeViewerCss, IncludeSearchCss (arama‑kısıtlı), IncludeAnnotationCss (açıklama‑kısıtlı).

ScriptConfig bayrakları: IncludeJQuery (tüm diğerleri için gereklidir), IncludeBootstrap, IncludeViewerScripts (core: docViewer.js + splitter + links), IncludeSearchScripts ve IncludeSearchBar (arama‑kısıtlı), IncludeAnnotationScripts ve IncludeAnnotationBar (açıklama‑kısıtlı).

@inject Doconut.Viewer Viewer

@Html.Raw(Viewer.ReferenceCss(new CssConfig { IncludeBootstrapCss = true, IncludeViewerCss = true }))
@Html.Raw(Viewer.ReferenceScripts(new ScriptConfig { IncludeJQuery = true, IncludeViewerScripts = true }))