Ρύθμιση σε .NET 6 ή νεότερο

Αρχείο Startup.cs

Στο αρχείο Startup.cs ενός έργου .NET Core, αυτές οι γραμμές κώδικα ορίζουν μια διαμόρφωση του pipeline μεσαίου λογισμικού χρησιμοποιώντας τη μέθοδο MapWhen. Το παρεχόμενο πρόβλεμμα ελέγχει αν το διαδρομή του εισερχόμενου αιτήματος τελειώνει με DocImage.axd. Μέσα σε αυτό το μπλοκ, η μέθοδος UseDoconut καλείται με ένα αντικείμενο DoconutOptions ως όρισμα.

app.MapWhen(
    context => context.Request.Path.ToString().EndsWith("DocImage.axd"),
    appBranch =>
    {
        appBranch.UseDoconut(new DoconutOptions { UnSafeMode = false, ShowDoconutInfo = false });
    }
);

Προσθήκη Doconut Namespaces

Στο έργο σας, προσθέστε τις ακόλουθες δηλώσεις using:

using Doconut;
using Doconut.Configs;
using Doconut.Formats;
using Doconut.Clouds;

Δημιουργία αντικειμένου Viewer

Αυτή η γραμμή δημιουργεί ένα νέο στιγμιότυπο της κλάσης Viewer, επιτρέποντάς σας να δημιουργήσετε ένα αντικείμενο viewer στον κώδικά σας.

var docViewer = new Viewer(_cache, _accessor, licenseFilePath);

Ρύθμιση ενός αντικειμένου DocOptions

Παράδειγμα αρχικοποίησης ενός αντικειμένου DocOptions με συγκεκριμένες ρυθμίσεις:

var documentOptions = new DocOptions
{
    Password = "",
    ImageResolution = 200,
    TimeOut = 30
};

Δημιουργία αντικειμένου ρυθμίσεων

Αρχικοποιήστε ένα νέο αντικείμενο PdfConfig με συγκεκριμένες ρυθμίσεις για τη διαχείριση εγγράφων PDF:

var config = new PdfConfig { DefaultRender = true, ExtractHyperlinks = true };

Ανοίξτε το έγγραφό σας

Αυτή η γραμμή καλεί τη μέθοδο OpenDocument του αντικειμένου προβολής, περνώντας τη διαδρομή του αρχείου εγγράφου που βρίσκεται στον διακομιστή και τα προηγουμένως διαμορφωμένα αντικείμενα PdfConfig και DocOptions ως παραμέτρους.

var token = docViewer.OpenDocument(pathToFile, config, documentOptions);

Προσθέστε τον προβολέα στο HTML σας

<div id="div_ctlDoc"></div>

Προσθήκη αρχείων CSS και JavaScript

Προσθέστε τα παρακάτω αρχεία CSS και JavaScript στη σελίδα. Αυτά τα σενάρια περιλαμβάνονται στο αρχείο ZIP με παραδείγματα κώδικα.

<!-- Main Viewer Related Scripts -->
<script src="scripts/splitter.js"></script>
<script src="scripts/docViewer.js"></script>
<script src="scripts/documentLinks.js"></script>

<!-- Viewer functions -->
<script src="scripts/docViewer.UI.js?v=1"></script>

Απαιτούμενα πακέτα NuGet

Για να εξασφαλίσετε ότι το έργο σας είναι πλήρως συμβατό με το .NET Core Standard, πρέπει να συμπεριληφθούν τα παρακάτω πακέτα NuGet, ταξινομημένα αλφαβητικά.

• MessagePack - Έκδοση 2.5.140
• Microsoft.Bcl.AsyncInterfaces - Έκδοση 8.0.0
• Microsoft.Extensions.Caching.Abstractions - Έκδοση 8.0.0
• Microsoft.Extensions.Configuration - Έκδοση 8.0.0
• Microsoft.Extensions.Configuration.Abstractions - Έκδοση 8.0.0
• Microsoft.Extensions.Configuration.FileExtensions - Έκδοση 8.0.0
• Microsoft.Extensions.Configuration.Json - Έκδοση 8.0.0
• Microsoft.Extensions.FileProviders.Abstractions - Έκδοση 8.0.0
• Microsoft.Extensions.FileProviders.Physical - Έκδοση 8.0.0
• Microsoft.Extensions.FileSystemGlobbing - Έκδοση 8.0.0
• Microsoft.Extensions.Primitives - Έκδοση 8.0.0
• System.Buffers - Έκδοση 4.5.1
• System.Formats.Asn1 - Έκδοση 8.0.0
• System.Numerics.Vectors - Έκδοση 4.5.0
• System.Security.Cryptography.Cng - Έκδοση 5.0.0
• System.Security.Cryptography.Pkcs - Έκδοση 8.0.0
• System.Text.Encoding.CodePages - Έκδοση 8.0.0
• System.Text.Encodings.Web - Έκδοση 8.0.0
• System.Text.Json - Έκδοση 8.0.3
• System.Threading.Tasks.Extensions - Έκδοση 4.5.4

Επιλογές Διαμόρφωσης Απόδοσης

Μπορείτε να διαμορφώσετε τη συμπεριφορά απόδοσης χρησιμοποιώντας τις παρακάτω επιλογές:

• CadConfig: Χρησιμοποιείται για αρχεία DWG, DXF και DGN.
• EmailConfig: Χρησιμοποιείται για αρχεία EML, EMLX και MSG.
• EpubConfig: Χρησιμοποιείται για αρχεία EPUB.
• ExcelConfig: Χρησιμοποιείται για αρχεία Excel και CSV.
• MhtConfig: Χρησιμοποιείται για αρχεία MHT.
• PptConfig: Χρησιμοποιείται για αρχεία PowerPoint.
• ProjectConfig: Χρησιμοποιείται για αρχεία MPP.
• PsdConfig: Χρησιμοποιείται για αρχεία PSD.
• TxtConfig: Χρησιμοποιείται για αρχεία TXT.
• TiffConfig: Χρησιμοποιείται για αρχεία TIFF.

Διαμόρφωση Επιλογών Απόδοσης

Οι επιλογές απόδοσης διαμορφώνονται χρησιμοποιώντας την ιδιότητα DefaultRender:

• DefaultRender = true : Αυτή η επιλογή προσφέρει απόδοση υψηλότερης ποιότητας, αλλά χρησιμοποιεί περισσότερη μνήμη διακομιστή και χρόνο επεξεργασίας.
• DefaultRender = false : Αυτή η επιλογή παρέχει ταχύτερη απόδοση με κόστος ελαφρώς μειωμένης ποιότητας.

Προσαρμοσμένες γραμματοσειρές σε έγγραφα Word

Η ιδιότητα FontFolders στην κλάση WordConfig καθορίζει προσαρμοσμένους καταλόγους όπου η εφαρμογή θα αναζητήσει γραμματοσειρές. Αυτό είναι ιδιαίτερα χρήσιμο για την επεξεργασία εγγράφων Word που βασίζονται σε γραμματοσειρές που δεν είναι εγκατεστημένες στους προεπιλεγμένους καταλόγους γραμματοσειρών του συστήματος.

var config = new WordConfig
{
    FontFolders = new string[] { "C:\\CustomFonts", "D:\\SharedFonts" }
};

Σημαντική Ενημέρωση για το Doconut 25.2.0

Είναι απαραίτητο να ενημερώσετε το πακέτο System.Text.Json στην έκδοση 8.0.5 σε όλα τα έργα σας. Αυτή η ενημέρωση είναι κρίσιμη για να εξασφαλιστεί η συμβατότητα με τις τελευταίες λειτουργίες και για την αντιμετώπιση σημαντικών βελτιώσεων ασφαλείας.

Κωδικοποίηση Email

Η ιδιότητα EmailEncoding στην κλάση EmailConfig καθορίζει την προτιμώμενη κωδικοποίηση τόσο για το θέμα όσο και για το σώμα του email.

var emailConfig = new EmailConfig {
    EmailEncoding = Encoding.UTF8 // Set preferred email encoding
};

Κωδικοποίηση Θέματος & Σώματος

Οι ιδιότητες SubjectEncoding και BodyEncoding στην κλάση EmailConfig ορίζουν την κωδικοποίηση που χρησιμοποιείται για το θέμα και το σώμα ενός email, αντίστοιχα.

var emailConfig = new EmailConfig {
    SubjectEncoding = Encoding.UTF8, // Set encoding for the subject
    BodyEncoding = Encoding.UTF8     // Set encoding for the body
};

Υποστήριξη Πολιτισμού Προβολέα Word

Η ιδιότητα DocumentCulture στην κλάση WordConfig σας επιτρέπει να ορίσετε ρητά τον πολιτισμό για αρχεία DOC και DOCX. Αυτό διασφαλίζει ότι το τοπικοποιημένο περιεχόμενο—όπως ημερομηνίες, νομίσματα και αριθμοί—αποδίδεται ακριβώς όπως στο Microsoft Word. Αυτό είναι ιδιαίτερα χρήσιμο για γλώσσες με συγκεκριμένες απαιτήσεις μορφοποίησης.

var config = new WordConfig { DocumentCulture = "he-IL" }; // Hebrew (Israel)
var config = new WordConfig { DocumentCulture = "ar-SA" }; // Arabic (Saudi Arabia)
var config = new WordConfig { DocumentCulture = "th-TH" }; // Thai (Thailand)
var config = new WordConfig { DocumentCulture = "ja-JP" }; // Japanese (Japan)