Προβολέας

Viewer (namespace Doconut) είναι το δημόσιο σημείο εισόδου για το άνοιγμα εγγράφων από Razor pages, MVC controllers, Blazor components ή minimal APIs. Είναι sealed, καταχωρημένο ως transient υπηρεσία από AddDoconut(), και επιλύεται μέσω injection κατασκευής — ποτέ μην το δημιουργείτε απευθείας.

Η προηγούμενη βιβλιοθήκη .NET Standard παρείχε δημόσιο constructor που έπαιρνε τη μνήμη cache, τον HTTP context accessor και μία ή περισσότερες διαδρομές αδειών. Αυτός ο constructor έχει αφαιρεθεί· το service graph παρέχει αυτές τις εξαρτήσεις.

Viewer δεν διατηρεί κατάσταση ανά αίτημα και σκόπιμα δεν υλοποιεί IDisposable: οι συνεδρίες εγγράφων ζουν ανεξάρτητα στην κρυφή μνήμη συνεδρίας, έτσι η διαγραφή της υπηρεσίας δεν μπορεί ποτέ να κλείσει ένα ανοιχτό έγγραφο (δείτε Core Concepts → How the Viewer Works).

OpenDocumentAsync

Ανοίγει ένα έγγραφο και επιστρέφει το token της συνεδρίας που χρησιμοποιεί το widget του πελάτη για όλες τις επόμενες αιτήσεις. Κάθε άνοιγμα είναι ασύγχρονο — δεν υπάρχει συγχρονική OpenDocument.

// Απλό άνοιγμα
string token = await viewer.OpenDocumentAsync(path);

// Με ρυθμίσεις και επιλογές ανά μορφή
token = await viewer.OpenDocumentAsync(
    path,
    new PdfConfig { AllowSearch = true, AllowCopy = true },
    new DocOptions { TimeOut = 30 });

// Από μια μεταφόρτωση
await using var ms = new MemoryStream();
await file.CopyToAsync(ms);
ms.Position = 0;
token = await viewer.OpenDocumentAsync(ms, new FileInfo(file.FileName));

Εξαιρέσεις προς διαχείριση:

• LicenseException — μια βρεθείσα άδεια απορρίπτεται (το μήνυμα μεταφέρει τον λόγο απόρριψης), ή η μορφή απαιτεί δυνατότητα plugin που δεν παρέχεται πλέον. Η λήξη του ημερολογίου χωρίς μήνυμα απόρριψης μετατρέπεται σε απόδοση με υδατογράφημα αντί για εξαίρεση.
• FormatNotSupportedException — Document format '<extension>' is not supported.
• InvalidDataException — το περιεχόμενο του αρχείου είναι κατεστραμμένο ή δεν ταιριάζει με την επέκτασή του.

CloseDocument

void CloseDocument(string token)

Αφαιρεί τη συνεδρία από την κρυφή μνήμη (αποδεσμεύει αμέσως τη μηχανή εγγράφου), διαγράφει το δείκτη ασφαλείας και ανακαλεί την άδεια πρόσβασης. Προαιρετικό — η κυλιόμενη λήξη εκτελεί τον ίδιο καθαρισμό — αλλά συνιστάται για μεγάλα έγγραφα.

GetPageCount

int GetPageCount(string token)

Συνολικές σελίδες της ανοιχτής συνεδρίας. Εξαίρεση εάν το token είναι άγνωστο ή ληγμένο.

GetWorksheetNames

IReadOnlyList<string> GetWorksheetNames(string token)

Επιστρέφει τα ονόματα των φύλλων εργασίας ενός ανοιχτού λογιστικού φύλλου, με τη σειρά του βιβλίου εργασίας, ή μια κενή λίστα όταν το ανοιχτό έγγραφο δεν είναι λογιστικό φύλλο.

Μόνο τα φύλλα εργασίας που έχουν αποδοθεί εμφανίζονται: κρυφά και κενά φύλλα εξαιρούνται, και όταν ExcelConfig.SheetNames περιορίζει την απόδοση, εμφανίζονται μόνο αυτά τα φύλλα. Ένα φύλλο εργασίας δεν είναι πάντα μία σελίδα — ένα πολύ μεγάλο μπορεί να αποδοθεί σε πολλές σελίδες. Εξαίρεση εάν το token είναι άγνωστο ή ληγμένο.

Προστέθηκε στην 26.9.0.

Σημαίες Δυνατοτήτων

Χρησιμοποιήστε αυτά σε μια Razor view για να αποδώσετε μια αδειοδοτημένη Ribbon μόνο όταν ο διακομιστής θα την εξυπηρετήσει πραγματικά — δείτε την Έναρξη.

DocOptions

Per-open, format-independent options (namespace Doconut):

Η κλάση εκθέτει επίσης εξειδικευμένες ιδιότητες που είναι σκόπιμα εκτός της κανονικής ροής προβολής μονής φιλοξενίας:

Προσαρμοσμένο υδατογράφημα

DocOptions.Watermark χρησιμοποιεί έξι πεδία χωρισμένα με tilde. Ένα προαιρετικό αρχικό ^ ζητά τη διάταξη σε όλες τις γωνίες:

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

Ο αναλυτής αναμένει ακριβώς έξι πεδία μετά το προαιρετικό ^. Μια μη έγκυρη ορισμός αντικαθίσταται από το ορατό fallback Invalid Watermark του SDK αντί να εξαφανιστεί σιωπηλά.

Απόφαση άδειας

Η ίδια απόφαση εφαρμόζεται στις εικόνες σελίδων που εξυπηρετούνται και στις εξαγωγές σχολίων. Η έξοδος Animated GIF σφραγίζεται καρέ‑καρέ. Έτσι, ένα προσαρμοσμένο υδατογράφημα είναι χαρακτηριστικό άδειας εφαρμογής, όχι τρόπος αντικατάστασης ή καταστολής του υδατογραφήματος αξιολόγησης.

API Σχολίων

Φόρτωση και εξαγωγή σχολίων στο διακομιστή. Ο πλήρης οδηγός βρίσκεται στις Οδηγίες → Σχόλια· η επιφάνεια είναι:

Κάθε ένα από αυτά λαμβάνει το διακριτικό της συνεδρίας. Η μορφή GetAnnotationManager(pageWidth, pageHeight) της προηγούμενης βιβλιοθήκης, χωρίς συνεδρία, παραμένει για τη δημιουργία σχολίων εκτός συνεδρίας, αλλά η φόρτωσή τους απαιτεί ακόμη διακριτικό.

Μεταδεδομένα DICOM

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

Η μέθοδος υπάρχει για ευθυγράμμιση του API, αλλά αυτό το πακέτο δεν μπορεί να παρέχει τεχνικές ετικέτες DICOM: ο αναγνώστης μεταδεδομένων διανέμεται μόνο σε έκδοση .NET 8. Επιστρέφει null για συνεδρίες DICOM και μη‑DICOM· σε συνεδρία DICOM γράφει επίσης μια εφάπαξ προειδοποίηση που εξηγεί τον περιορισμό της πλατφόρμας. Η απόδοση σελίδας, πλαισίου και animation παραμένει υποστηριζόμενη.

Βοηθοί πόρων — ReferenceCss / ReferenceScripts

Εκδώστε τις ετικέτες <link>/<script> για τους ενσωματωμένους πόρους που παρέχονται από UseDoconutResources(), με τη σωστή σειρά εξαρτήσεων. Τα πακέτα για λειτουργίες υπό άδεια, όπως η αναζήτηση και το σχόλιο, εκδίδονται μόνο όταν η άδεια τις ενεργοποιεί, διατηρώντας το UI του πελάτη συνεπές με τη συμπεριφορά του διακομιστή.

string ReferenceCss(CssConfig? config = null)      // null → Bootstrap + προβολέας + αναζήτηση + σχόλιο
string ReferenceScripts(ScriptConfig? config = null)

CssConfig σημαίες: IncludeBootstrapCss, IncludeViewerCss, IncludeSearchCss (υπό έλεγχο αναζήτησης), IncludeAnnotationCss (υπό έλεγχο σχολίων).

ScriptConfig σημαίες: IncludeJQuery (απαιτείται από όλα τα άλλα), IncludeBootstrap, IncludeViewerScripts (πυρήνας: docViewer.js + splitter + links), IncludeSearchScripts και IncludeSearchBar (υπό έλεγχο αναζήτησης), IncludeAnnotationScripts και IncludeAnnotationBar (υπό έλεγχο σχολίων).

@inject Doconut.Viewer Viewer

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

Αυτοί οι βοηθοί είναι ο υποστηριζόμενος τρόπος παροχής των πόρων του προγράμματος περιήγησης. Εφαρμογές που αντιγράψανε τα docViewer.js, documentLinks.js και docViewer.UI.js στο wwwroot θα πρέπει να αφαιρέσουν αυτά τα αντίγραφα μόλις η σελίδα αποδοθεί από τις εκπεμπόμενες ετικέτες.