Görüntüleyici

Viewer (namespace Doconut) Razor sayfalarından, MVC denetleyicilerinden, Blazor bileşenlerinden veya minimal API'lerden belge açmak için kullanılan genel giriş noktasını sağlar. sealeddır, AddDoconut() ile transient hizmet olarak kaydedilir ve ctor enjeksiyonu ile çözülür — doğrudan örneklenmez.

Viewer hiçbir 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 dispose etmek açık bir belgeyi asla kapatamaz (bkz. Core Concepts → How the Viewer Works).

OpenDocumentAsync - Belge Açma

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 ister. Reddetme mesajı olmadan takvim süresi dolduğunda, hata fırlatmak yerine su işaretli render’a geçilir.
• FormatNotSupportedException — Document format '<extension>' is not supported.
• InvalidDataException — dosya içeriği bozuk veya uzantısıyla eşleşmiyor.

CloseDocument - Belge Kapatma

void CloseDocument(string token)

Oturumu önbellekten kaldırır (belge motorunu hemen dispose 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 - Sayfa Sayısını Al

int GetPageCount(string token)

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

DocOptions - Açma‑Sırasında Format‑Bağımsız Seçenekler (namespace Doconut)

Sınıf ayrıca normal tek‑host görüntüleme akışının dışındaki özel senaryolar için tasarlanmış özellikler sunar:

Custom watermark - Özel Filigran

DocOptions.Watermark altı tilde‑ayırıcı alana sahiptir. İsteğe bağlı bir 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
    });

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

License decision - Lisans Kararı

Aynı karar, sunulan sayfa görüntüleri ve açıklama dışa aktarımları için uygulanır. Animasyonlu GIF çıktısı kare‑kare damgalanır. Özel bir filigran, bu yüzden bir lisanslı uygulama özelliğidir; değerlendirme filigranını değiştirmek veya bastırmak için kullanılmaz.

Annotations API - Açıklama API'si

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

DICOM metadata - DICOM Meta Verileri

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

DICOM eklentisi aracılığıyla açılan oturumlar için DICOM etiket meta verilerini döndürür; DICOM olmayan belgeler için null.

Resource helpers — ReferenceCss / ReferenceScripts - Kaynak Yardımcıları

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 için paketler yalnızca lisans etkinleştirdiğinde üretilir, 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 gerekli), 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 }))