Betrachter

Viewer (Namespace Doconut) ist der öffentliche Einstiegspunkt zum Öffnen von Dokumenten aus Razor‑Seiten, MVC‑Controllern, Blazor‑Komponenten oder Minimal‑APIs. Er ist sealed, wird von AddDoconut() als transient‑Dienst registriert und über Konstruktor‑Injection aufgelöst — er darf niemals direkt instanziiert werden.

Viewer hält keinen per‑Request‑Zustand und implementiert bewusst nicht IDisposable: Dokument‑Sitzungen leben eigenständig im Sitzungs‑Cache, sodass das Entsorgen des Dienstes niemals ein offenes Dokument schließen könnte (siehe Core Concepts → Wie der Betrachter funktioniert).

OpenDocumentAsync

Öffnet ein Dokument und gibt das Sitzungs‑Token zurück, das das Client‑Widget für alle nachfolgenden Anfragen verwendet.

// 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));

Auszuwertende Ausnahmen:

• LicenseException — eine gefundene Lizenz wird abgelehnt (die Meldung enthält den Ablehnungsgrund) oder das Format benötigt eine Plugin‑Fähigkeit, die nicht mehr gewährt wird. Das Ablaufdatum des Kalenders ohne Ablehnungsnachricht führt zu einer wasserzeichenbasierten Darstellung anstelle einer Ausnahme.
• FormatNotSupportedException — Document format '<extension>' is not supported.
• InvalidDataException — der Dateiinhalt ist beschädigt oder stimmt nicht mit seiner Erweiterung überein.

CloseDocument

void CloseDocument(string token)

Entfernt die Sitzung aus dem Cache (der Dokument‑Engine wird sofort entsorgt), löscht den Sicherheits‑Marker und widerruft die Zugriffs‑Gewährung. Optional — Sliding‑Expiration führt dieselbe Bereinigung durch — wird jedoch für große Dokumente empfohlen.

GetPageCount

int GetPageCount(string token)

Gesamtzahl der Seiten der offenen Sitzung. Wirft eine Ausnahme, wenn das Token unbekannt oder abgelaufen ist.

DocOptions

Pro‑Öffnung, format‑unabhängige Optionen (Namespace Doconut):

Die Klasse stellt zudem spezialisierte Eigenschaften bereit, die bewusst außerhalb des normalen Single‑Host‑Viewing‑Flows liegen:

Benutzerdefiniertes Wasserzeichen

DocOptions.Watermark verwendet sechs durch Tilde getrennte Felder. Ein optional führendes ^ fordert das All‑Corners‑Layout an:

^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
    });

Der Parser erwartet exakt sechs Felder nach dem optionalen ^. Eine ungültige Definition wird durch das im SDK sichtbare Invalid Watermark‑Fallback ersetzt, anstatt still zu verschwinden.

Lizenz‑Entscheidung

Die gleiche Entscheidung wird auf bereitgestellte Seitenbilder und Anmerkungs‑Exporte angewendet. Bei animierten GIF‑Ausgaben wird jedes Bild einzeln gestempelt. Ein benutzerdefiniertes Wasserzeichen ist daher ein lizenziertes Anwendungs‑Feature und kein Mittel, das Evaluierungs‑Wasserzeichen zu ersetzen oder zu unterdrücken.

Anmerkungen‑API

Serverseitiges Laden und Exportieren von Anmerkungen. Der komplette Leitfaden befindet sich in Guides → Anmerkungen; die Oberfläche lautet:

DICOM‑Metadaten

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

Die Methode dient nur der API‑Ausrichtung, aber der .NET 6 DICOM‑Viewer kann keine technischen Tags liefern. Sie gibt null für DICOM‑ und Nicht‑DICOM‑Sitzungen zurück; bei einer DICOM‑Sitzung wird zudem einmalig eine Warnung ausgegeben, die die Plattform‑Beschränkung erklärt. Seiten‑, Frame‑ und Animations‑Rendering bleiben unterstützt.

Ressourcen‑Hilfsfunktionen — ReferenceCss / ReferenceScripts

Erzeugt die <link>‑/<script>‑Tags für die eingebetteten Ressourcen, die von UseDoconutResources() bereitgestellt werden, in korrekter Abhängigkeits‑Reihenfolge. Bündel für lizenz‑gesteuerte Features wie Suche und Anmerkungen werden nur dann ausgegeben, wenn die Lizenz sie aktiviert, sodass die Client‑UI mit dem Server‑Verhalten konsistent bleibt.

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

CssConfig‑Flags: IncludeBootstrapCss, IncludeViewerCss, IncludeSearchCss (search‑gated), IncludeAnnotationCss (annotation‑gated).

ScriptConfig‑Flags: IncludeJQuery (erforderlich für alle anderen), IncludeBootstrap, IncludeViewerScripts (core: docViewer.js + splitter + links), IncludeSearchScripts und IncludeSearchBar (search‑gated), IncludeAnnotationScripts und IncludeAnnotationBar (annotation‑gated).

@inject Doconut.Viewer Viewer

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