Ρύθμιση σε .NET Standard / Core

Αρχείο Startup.cs

Στο αρχείο Startup.cs ενός έργου .NET Core, αυτές οι γραμμές κώδικα ορίζουν τη διαμόρφωση της αλυσίδας ενδιάμεσων λογισμικών (middleware) χρησιμοποιώντας τη μέθοδο 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

Στο έργο σας, προσθέστε τις ακόλουθες δηλώσεις 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
};

Διαμόρφωση αντικειμένου config

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

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

Άνοιγμα του εγγράφου σας

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

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

Προσθήκη του viewer στο HTML σας

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

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

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

<link rel="stylesheet" href="css/viewer.css" />

<!-- Main Viewer Related Scripts -->
<script src="scripts/jquery.min.js"></script>
<script src="scripts/docViewer.js"></script>
<script src="scripts/splitter.js"></script>
<script src="scripts/search.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 - Version 2.5.140
• Microsoft.Bcl.AsyncInterfaces - Version 8.0.0
• Microsoft.Extensions.Caching.Abstractions - Version 8.0.0
• Microsoft.Extensions.Configuration - Version 8.0.0
• Microsoft.Extensions.Configuration.Abstractions - Version 8.0.0
• Microsoft.Extensions.Configuration.FileExtensions - Version 8.0.0
• Microsoft.Extensions.Configuration.Json - Version 8.0.0
• Microsoft.Extensions.FileProviders.Abstractions - Version 8.0.0
• Microsoft.Extensions.FileProviders.Physical - Version 8.0.0
• Microsoft.Extensions.FileSystemGlobbing - Version 8.0.0
• Microsoft.Extensions.Primitives - Version 8.0.0
• System.Buffers - Version 4.5.1
• System.Formats.Asn1 - Version 8.0.0
• System.Numerics.Vectors - Version 4.5.0
• System.Security.Cryptography.Cng - Version 5.0.0
• System.Security.Cryptography.Pkcs - Version 8.0.0
• System.Text.Encoding.CodePages - Version 8.0.0
• System.Text.Encodings.Web - Version 8.0.0
• System.Text.Json - Version 8.0.3
• System.Threading.Tasks.Extensions - Version 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 που βασίζονται σε γραμματοσειρές που δεν είναι εγκατεστημένες στους προεπιλεγμένους καταλόγους γραμματοσειρών του system's.

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

Λήψη απαιτούμενων αρχείων CSS και JS

Για να λειτουργεί σωστά το Doconut, πρέπει να συμπεριλάβετε συγκεκριμένα αρχεία CSS και JS στο έργο σας. Μπορείτε να κατεβάσετε ένα αρχείο ZIP που περιέχει όλα τα απαραίτητα αρχεία χρησιμοποιώντας το παρακάτω σύνδεσμο:

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)