Configurazione in .NET Standard / Core

File Startup.cs

Nell file Startup.cs di un progetto .NET Core, queste righe di codice definiscono una configurazione della pipeline middleware utilizzando il metodo MapWhen. Il predicato fornito verifica se il percorso della richiesta in ingresso termina con DocImage.axd. All'interno di questo blocco, viene chiamato il metodo UseDoconut con un oggetto DoconutOptions come argomento.

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

Aggiungere gli spazi dei nomi Doconut

Nel tuo progetto, aggiungi le seguenti istruzioni using:

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

Istanziare l'oggetto Viewer

Questa riga istanzia una nuova istanza della classe Viewer, consentendoti di creare un oggetto viewer nel tuo codice.

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

Configurare un oggetto DocOptions

Esempio di inizializzazione di un oggetto DocOptions con configurazioni specifiche:

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

Configurare un oggetto config

Inizializza un nuovo oggetto PdfConfig con configurazioni specifiche per la gestione dei documenti PDF:

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

Apri il tuo documento

Questa riga invoca il metodo OpenDocument dell'oggetto viewer, passando il percorso del file del documento situato sul server e gli oggetti PdfConfig e DocOptions precedentemente configurati come parametri.

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

Aggiungi il viewer nel tuo HTML

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

Aggiungi file CSS e JavaScript

Aggiungi i seguenti file CSS e JavaScript nella pagina. Questi script sono inclusi nel file ZIP con esempi di codice.

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

Pacchetti NuGet richiesti

Per garantire che il tuo progetto sia pienamente compatibile con .NET Core Standard, è necessario includere i seguenti pacchetti NuGet, elencati in ordine alfabetico.

• 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

Opzioni di configurazione del rendering

Puoi configurare il comportamento del rendering utilizzando le seguenti opzioni:

• CadConfig: Utilizzato per file DWG, DXF e DGN.
• EmailConfig: Utilizzato per file EML, EMLX e MSG.
• EpubConfig: Utilizzato per file EPUB.
• ExcelConfig: Utilizzato per file Excel e CSV.
• MhtConfig: Utilizzato per file MHT.
• PptConfig: Utilizzato per file PowerPoint.
• ProjectConfig: Utilizzato per file MPP.
• PsdConfig: Utilizzato per file PSD.
• TxtConfig: Utilizzato per file TXT.
• TiffConfig: Utilizzato per file TIFF.

Configurazione delle opzioni di rendering

Le opzioni di rendering sono configurate utilizzando la proprietà DefaultRender:

• DefaultRender = true : Questa opzione offre un rendering di qualità superiore ma utilizza più memoria del server e tempo di elaborazione.
• DefaultRender = false : Questa opzione fornisce un rendering più veloce a scapito di una leggera diminuzione della qualità.

Font personalizzati nei documenti Word

La proprietà FontFolders nella classe WordConfig specifica cartelle personalizzate dove l'applicazione cercherà i font. Ciò è particolarmente utile per elaborare documenti Word che dipendono da font non installati nelle cartelle di font predefinite del sistema.

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

Aggiornamento importante per Doconut 25.2.0

È fondamentale aggiornare il pacchetto System.Text.Json alla versione 8.0.5 in tutti i tuoi progetti. Questo aggiornamento è cruciale per garantire la compatibilità con le ultime funzionalità e per affrontare importanti miglioramenti di sicurezza.

Codifica email

La proprietà EmailEncoding nella classe EmailConfig specifica la codifica preferita sia per l'oggetto che per il corpo dell'email.

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

Codifica oggetto & corpo

Le proprietà SubjectEncoding e BodyEncoding nella classe EmailConfig definiscono la codifica utilizzata rispettivamente per l'oggetto e il corpo di un'email.

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

Supporto della cultura del visualizzatore Word

La proprietà DocumentCulture nella classe WordConfig consente di definire esplicitamente la cultura per i file DOC e DOCX. Questo garantisce che i contenuti localizzati—come date, valute e numeri—vengano renderizzati esattamente come avviene in Microsoft Word. È particolarmente utile per le lingue con requisiti di formattazione specifici.

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)

Scarica i file CSS e JS richiesti

Per garantire che Doconut funzioni correttamente, è necessario includere specifici file CSS e JS nel tuo progetto. Puoi scaricare un file ZIP contenente tutti i file necessari utilizzando il link qui sotto: