Θα έχετε έναν αυτο‑φιλοξενούμενο, αστραπιαία‑γρήγορο προβολέα εγγράφων που τρέχει μέσα στην εφαρμογή .NET σας

Στο τέλος αυτού του οδηγού θα μπορείτε να ανοίξετε PDF, αρχεία Office, σχέδια CAD και δεκάδες άλλες μορφές απευθείας στον περιηγητή, με χρόνους φόρτωσης κάτω του δευτερολέπτου, χωρίς εξωτερικές κλήσεις SaaS και με πλήρη έλεγχο της ασφάλειας.

Προαπαιτούμενα

Τι χρειάζεστε	Γιατί είναι σημαντικό
.NET 6 ή νεότερο (το SDK στοχεύει στο .NET 6+)	Εγγυάται τη συμβατότητα με το Online Document Viewer SDK
Ένας διακομιστής Windows ή Linux όπου μπορείτε να εκτελέσετε την εφαρμογή σας (τοπικά ή σε ιδιωτικό σύννεφο)	Η αυτο‑φιλοξενία απαιτεί ο προβολέας να λειτουργεί μέσα στην δική σας υποδομή
Πρόσβαση στο Online Document Viewer NuGet feed (https://doconut.com)	Το SDK διανέμεται ως πακέτο NuGet
Βασικές γνώσεις ASP.NET Core και front‑end JavaScript	Το front‑end ζητά από το API σας ένα token προεπισκόπησης, παρέχοντας το αναγνωριστικό του εγγράφου
Μια τοποθεσία αποθήκευσης για τα αρχεία προέλευσης (σύστημα αρχείων, αποθήκευση blob κ.λπ.)	Ο προβολέας αποδίδει αρχεία από τοπική ή δικτυακή διαδρομή· η πηγή πρέπει να είναι προσβάσιμη από τη διαδικασία του διακομιστή

Η έλλειψη οποιουδήποτε από αυτά τα στοιχεία θα προκαλέσει την διακοπή της δημιουργίας πριν εκτελεστεί η πρώτη γραμμή κώδικα.

Εγκατάσταση του Online Document Viewer SDK

Ανοίξτε τη λύση σας στο Visual Studio ή στο προτιμώμενο IDE σας και προσθέστε το επίσημο SDK μέσω του διαχειριστή NuGet:

dotnet add package Doconut.NET8

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

Αφού αποκατασταθεί το πακέτο, καταχωρίστε τις υπηρεσίες SDK στο Program.cs (ή στο Startup.cs για παλαιότερα πρότυπα). Η καταγραφή ενσωματώνει τη γραμμή παραγωγής στο DI container του ASP.NET Core, καθιστώντας την διαθέσιμη στους ελεγκτές σας.

Διαμόρφωση της γραμμής απόδοσης για τις απαιτούμενες μορφές

Ο προβολέας υποστηρίζει περισσότερες από 50 μορφές έτοιμες προς χρήση, συμπεριλαμβανομένων:

PDF, DOC, DOCX, ODT, RTF
XLS, XLSX, CSV, ODS
PPT, PPTX, ODP
DWG, DXF, DGN (CAD)
PSD, SVG, TIFF, WEBP, ICO
EML, MSG, EPUB, MOBI, MPP, VSD

Όταν λαμβάνεται ένα αίτημα, το SDK καθορίζει τον τύπο του αρχείου και επιλέγει τον κατάλληλο μετατροπέα. Για βέλτιστη απόδοση, ενεργοποιήστε το ενσωματωμένο επίπεδο caching που αποθηκεύει τη σελίδα απόδοσης στη μνήμη για τη διάρκεια του αιτήματος· αυτό είναι που παρέχει την εμπειρία «Αστραπιαία Γρήγορη – Άμεση απόδοση εγγράφου με βελτιστοποιημένη απόδοση και φόρτωση κάτω του δευτερολέπτου».

Στον ελεγκτή σας, καλέστε τη μέθοδο απόδοσης του SDK (π.χ., RenderAsync) και περάστε την απόλυτη διαδρομή του αρχείου προέλευσης. Η μέθοδος επιστρέφει ένα τμήμα HTML που περιέχει έναν προβολέα βασισμένο σε canvas. Επειδή η απόδοση γίνεται στον διακομιστή, ο πελάτης λαμβάνει μόνο έτοιμο markup για προβολή, κάτι που εξαλείφει την βαριά επεξεργασία στην πλευρά του πελάτη.

Ασφάλιση του προβολέα με URLs βασισμένα σε token και προαιρετικούς περιορισμούς

Η κυριαρχία των δεδομένων και η συμμόρφωση με το GDPR είναι κοινές ανησυχίες για εγκαταστάσεις on‑premise. Το SDK ενσωματώνεται με το σύστημα αυθεντικοποίησης του ASP.NET Core, επιτρέποντάς σας να δημιουργήσετε ένα υπογεγραμμένο token που παρέχει εφάπαξ πρόσβαση σε ένα συγκεκριμένο έγγραφο.

Τυπική ροή:

Το front‑end ζητά από το API σας ένα token προεπισκόπησης, παρέχοντας το αναγνωριστικό του εγγράφου.
Το API σας επικυρώνει τα δικαιώματα του χρήστη, δημιουργεί ένα token τύπου JWT που κωδικοποιεί τη διαδρομή του αρχείου και μια χρονική σήμανση λήξης, και επιστρέφει το token.
Το front‑end προσθέτει το token στη URL του προβολέα (π.χ., /viewer?token=…). Το SDK επικυρώνει το token σε κάθε αίτημα και απορρίπτει οποιοδήποτε τροποποιημένο ή ληγμένο token.

Αν χρειάζεται να αποτρέψετε τους χρήστες από τη λήψη ή την εκτύπωση του εγγράφου, ρυθμίστε τις επιλογές απόδοσης που παρέχει το SDK ώστε να απενεργοποιήσετε αυτές τις ενέργειες. Η JavaScript στρώση του προβολέα θα κρύψει το κουμπί λήψης, θα καταστέλλει τη συντόμευση εκτύπωσης και θα μπλοκάρει το μενού δεξί‑κλικ.

Επαλήθευση ότι όλα λειτουργούν

Μεταβείτε στη σελίδα που φιλοξενεί τον προβολέα.
Το έγγραφο θα πρέπει να εμφανίζεται μέσα σε ένα δευτερόλεπτο, με γραμμές κύλισης, εργαλεία ζουμ και πεδίο αναζήτησης.
Αν ρυθμίσατε τον προβολέα ώστε να απενεργοποιήσετε τη λήψη, το κουμπί «Download» πρέπει να είναι κρυφό.
Το δεξί‑κλικ στο έγγραφο δεν πρέπει να ανοίγει το μενού περιβάλλοντος του προγράμματος περιήγησης όταν αυτή η περιοριστική ρύθμιση είναι ενεργή.
Αφού λήξει το token (η προεπιλογή είναι 5 λεπτά), η ανανέωση της σελίδας πρέπει να επιστρέφει σφάλμα «401 Unauthorized», επιβεβαιώνοντας ότι η επικύρωση του token είναι ενεργή.

Αν κάποιος από αυτούς τους ελέγχους αποτύχει, επανεξετάστε το αντίστοιχο βήμα: έλλειψη καταχώρισης SDK, εσφαλμένη δημιουργία token ή παραλειπόμενες σημαίες ασφαλείας.