Ο βασικός προβολέας Doconut για .NET 6 διανέμεται ως ένα πακέτο NuGet που ενσωματώνεται σε οποιαδήποτε εφαρμογή ASP.NET Core. Τα προαιρετικά πρόσθετα χρησιμοποιούν ξεχωριστά πακέτα. Αυτή η σελίδα εγκαθιστά το βασικό πακέτο και καταχωρίζει το middleware — το ελάχιστο που απαιτείται πριν από την πρώτη σας απόδοση.

Εγκατάσταση του πακέτου

bash

dotnet add package Doconut.NET6

Η εντολή χωρίς έκδοση εγκαθιστά την πιο πρόσφατη σταθερή έκδοση. Για να αναπαράγετε ακριβώς την τρέχουσα έκδοση 26.7.0, περάστε την έκδοση ως ξεχωριστή επιλογή:

bash

dotnet add package Doconut.NET6 --version 26.7.0

Doconut.NET6 είναι το ID του πακέτου. Το επίθημα .26.7.0 ανήκει στο ληφθέν αρχείο Doconut.NET6.26.7.0.nupkg και δεν αποτελεί μέρος του ID.

Αναγνώριση της ενσωμάτωσης πριν από την αναβάθμιση

Το ID του πακέτου Doconut.NET6 έχει χρησιμοποιηθεί τόσο από την κλασική όσο και από την τρέχουσα ενσωμάτωση .NET 6. Μην επιλέγετε τεκμηρίωση μόνο από το όνομα του πακέτου:

DocImage.axd, new Viewer(_cache, _accessor, ...), synchronous OpenDocument(...), και τα χειροκίνητα αντιγραμμένα scripts του προβολέα προσδιορίζουν την κλασική ενσωμάτωση;
AddDoconut(), UseDoconutResources(), ένας ενσωματωμένος Viewer, και OpenDocumentAsync(...) προσδιορίζουν την τρέχουσα ενσωμάτωση που τεκμηριώνεται εδώ.

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

Καταχώριση του Doconut

AddDoconut() είναι το μοναδικό σημείο εισόδου για καταχώριση — υπάρχει μία μόνο υπερφόρτωση, και συνδέει την υπηρεσία Viewer, την υπηρεσία άδειας και την υποδομή απόδοσης στο DI container.

Δύο κλήσεις middleware ολοκληρώνουν τη ρύθμιση, και η σειρά τους είναι σημαντική: UseDoconutResources() πρέπει να εκτελείται πριν από UseDoconut(). Το UseDoconut() είναι τελικό middleware, έτσι η κλήση του πρώτα σημαίνει ότι κάθε αίτημα σε έναν πόρο /doconut-res δεν φτάνει ποτέ στον διαχειριστή πόρων και επιστρέφει 404. Η σύνδεση της συνεδρίας απαιτείται επίσης — η προεπιλεγμένη ασφάλεια εγγράφων του Doconut επικυρώνει κάθε αίτημα σελίδας έναντι της κατάστασης συνεδρίας ASP.NET.

csharp

builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddSession(); // Doconut document security rides on ASP.NET session state

app.UseSession();          // call UseSession() before UseDoconut()
app.UseDoconutResources(); // must be registered before UseDoconut()
app.UseDoconut();

Όλες οι επιλογές

DoconutOptions δέχεται τις παρακάτω ρυθμιζόμενες ιδιότητες. Κάθε μία είναι προαιρετική — οι προεπιλογές παρακάτω ισχύουν όταν μια ιδιότητα παραμείνει ακαθορισμένη.

Property	Default	Description
`ShowDoconutInfo`	`false`	Όταν είναι `true`, ένα αίτημα χωρίς `token` επιστρέφει μια ετικέτα έκδοσης αντί για 404. Χρήσιμο ως γρήγορος έλεγχος· απενεργοποιήστε το σε παραγωγή.
`UnsafeMode`	`false`	Όταν είναι `true`, παραλείπει τον έλεγχο ασφαλείας της συνεδρίας ASP.NET στα αιτήματα σελίδας. Απενεργοποιήστε το σε παραγωγή.
`MiddlewarePath`	`"/doconut"`	Τιμή συντονισμού για το endpoint εικόνας-σελίδας. Επικυρώνεται, αλλά δεν δημιουργεί κλάδο από μόνη της· διατηρήστε τη ευθυγραμμισμένη με την πραγματική αντιστοίχιση `UseDoconut()` και το `BasePath` του πελάτη.
`ResourcesPath`	`"/doconut-res"`	Πού εξυπηρετούνται οι ενσωματωμένοι πόροι JS/CSS/εικόνας.
`LicensePath`	`""` (empty string)	Διαδρομή προς το αρχείο άδειας. Κενό σημαίνει μετάβαση στην επόμενη πηγή, στη συνέχεια αυτόματη αναζήτηση.
`LicenseContent`	`""` (empty string)	Ακατέργαστο περιεχόμενο άδειας — από μεταβλητή περιβάλλοντος, διαχειριστή μυστικών ή βάση δεδομένων.
`LicenseStream`	`null`	Άδεια ως ροή, διαβάζεται μία φορά κατά την εκκίνηση.
`ResetLicense`	`false`	Δεσμευμένη σημαία συμβατότητας. Οι τρέχουσες υπηρεσίες .NET 6 διαβάζουν την άδεια κατά το `AddDoconut()`· επανεκκινήστε την εφαρμογή μετά την αντικατάσταση μιας άδειας.

Προτεραιότητα άδειας όταν ορίζονται περισσότερες από μία πηγές: LicenseStream υπερισχύει του LicenseContent, που υπερισχύει του LicensePath, που υπερισχύει της αυτόματης αναζήτησης — δείτε το Ρύθμιση Άδειας.

csharp

builder.Services.AddDoconut(options =>
{
    options.LicensePath     = "Doconut.Viewer.lic";
    options.MiddlewarePath  = "/doconut";     // coordinate with app mapping and client BasePath
    options.ResourcesPath   = "/doconut-res"; // where the viewer's JS/CSS/images are served from
    options.UnsafeMode      = false;          // keep session security on
    options.ShowDoconutInfo = false;
});

Επόμενα βήματα

Γρήγορη Εκκίνηση — ανοίξτε το πρώτο σας έγγραφο και αποδώστε το στον περιηγητή.
Ρύθμιση Άδειας — όπου το Doconut ψάχνει για το αρχείο άδειας σας.