Nastavení v .NET Standard / Core

Soubor Startup.cs

V souboru Startup.cs projektu .NET Core tyto řádky kódu definují konfiguraci middleware pipeline pomocí metody MapWhen. Poskytnutá podmínka kontroluje, zda cesta příchozího požadavku končí na DocImage.axd. Uvnitř tohoto bloku je zavolána metoda UseDoconut s objektem DoconutOptions jako argumentem.

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

Přidat jmenné prostory Doconut

Ve vašem projektu přidejte následující using direktivy:

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

Vytvořit instanci objektu Viewer

Tento řádek vytvoří novou instanci třídy Viewer, což vám umožní vytvořit objekt viewer ve vašem kódu.

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

Nastavit objekt DocOptions

Příklad inicializace objektu DocOptions s konkrétními nastaveními:

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

Nastavit konfigurační objekt

Inicializujte nový objekt PdfConfig s konkrétními nastaveními pro zpracování PDF dokumentů:

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

Otevřít váš dokument

Tento řádek volá metodu OpenDocument objektu viewer, předává cestu k souboru dokumentu umístěnému na serveru a dříve nakonfigurované objekty PdfConfig a DocOptions jako parametry.

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

Přidat viewer do vašeho HTML

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

Přidat soubory CSS a JavaScript

Přidejte následující soubory CSS a JavaScript na stránku. Tyto skripty jsou zahrnuty v ZIP souboru s ukázkovým kódem.

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

Požadované balíčky NuGet

Aby byl váš projekt plně kompatibilní s .NET Core Standard, je třeba zahrnout následující NuGet balíčky, uvedené v abecedním pořadí.

• 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

Možnosti konfigurace renderování

Můžete nastavit chování renderování pomocí následujících možností:

• CadConfig: Používá se pro soubory DWG, DXF a DGN.
• EmailConfig: Používá se pro soubory EML, EMLX a MSG.
• EpubConfig: Používá se pro soubory EPUB.
• ExcelConfig: Používá se pro soubory Excel a CSV.
• MhtConfig: Používá se pro soubory MHT.
• PptConfig: Používá se pro soubory PowerPoint.
• ProjectConfig: Používá se pro soubory MPP.
• PsdConfig: Používá se pro soubory PSD.
• TxtConfig: Používá se pro soubory TXT.
• TiffConfig: Používá se pro soubory TIFF.

Konfigurace možností renderování

Možnosti renderování jsou konfigurovány pomocí vlastnosti DefaultRender:

• DefaultRender = true : Tato možnost poskytuje vyšší kvalitu renderování, ale používá více paměti serveru a výpočetního času.
• DefaultRender = false : Tato možnost poskytuje rychlejší renderování na úkor mírně snížené kvality.

Vlastní fonty ve Word dokumentech

Vlastnost FontFolders ve třídě WordConfig určuje vlastní adresáře, ve kterých bude aplikace hledat fonty. To je zvláště užitečné pro zpracování Word dokumentů, které spoléhají na fonty nenainstalované v systém's výchozích adresářích fontů.

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

Důležitá aktualizace pro Doconut 25.2.0

Je nezbytné aktualizovat balíček System.Text.Json na verzi 8.0.5 ve všech vašich projektech. Tato aktualizace je klíčová pro zajištění kompatibility s nejnovějšími funkcemi a pro řešení důležitých bezpečnostních vylepšení.

Kódování e‑mailu

Vlastnost EmailEncoding ve třídě EmailConfig určuje preferované kódování jak předmětu, tak těla e‑mailu.

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

Kódování předmětu a těla

Vlastnosti SubjectEncoding a BodyEncoding ve třídě EmailConfig definují kódování použité pro předmět a tělo e‑mailu, respektive.

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

Stáhněte požadované soubory CSS a JS

Aby Doconut fungoval správně, musíte do svého projektu zahrnout konkrétní soubory CSS a JS. Kompletní soubory můžete stáhnout ve formátu ZIP pomocí níže uvedeného odkazu:

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)