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ý predikát kontroluje, zda cesta příchozího požadavku končí na DocImage.axd. Uvnitř tohoto bloku je volána metoda UseDoconut s objektem DoconutOptions jako argumentem.

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

Přidat Doconut jmenné prostory

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

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

Vytvořit objekt Viewer

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

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

Nastavení objektu DocOptions

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

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

Nastavte konfigurační objekt

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

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

Otevřete svůj dokument

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

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

Přidejte prohlížeč do svého HTML

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.

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

Přidejte licence do svého projektu

Automatické rozpoznání licence

Pro inicializaci docVieweru s automatickým rozpoznáním licence použijte následující řádek:

C#
var docViewer = new Viewer(_cache, _accessor);

Přidat výchozí licenci ručně

Při inicializaci prohlížeče můžete ručně zadat cestu k jedinému výchozímu souboru licence.

C#
var licenseFilePath = Path.Combine(_hostingEnvironment.WebRootPath, "path/to/your/license");
var docViewer = new Viewer(_cache, _accessor, licenseFilePath);

Přidat licenci pomocí streamu

Tato metoda používá přetížení Viewer.DoconutLicense(Stream licenseStream) k přidání licence pomocí streamu.

C#
using (var licenseStream = new FileStream("path/to/your/license", FileMode.Open))
{
    Viewer.DoconutLicense(licenseStream);
}

Přidat licenci pomocí XML dokumentu

Tato metoda používá přetížení Viewer.DoconutLicense(XMLDocument licence) k přidání licence pomocí XML dokumentu.

C#
var xmlDoc = new XmlDocument();
xmlDoc.Load("path/to/your/license.xml");
Viewer.DoconutLicense(xmlDoc);

Ruční výchozí více pluginových licencí

Pokud potřebujete zadat více licencí, můžete poskytnout seznam cest k souborům při inicializaci prohlížeče.

C#
List<string> licenseFilePaths = new List<string>
{
    Path.Combine(_hostingEnvironment.WebRootPath, "Doconut.Viewer.lic"),
    Path.Combine(_hostingEnvironment.WebRootPath, "Doconut.Viewer.Annotation.lic"),
    Path.Combine(_hostingEnvironment.WebRootPath, "Doconut.Viewer.Search.lic")
};
var docViewer = new Viewer(_cache, _accessor, licenseFilePaths);

Přidat pluginovou licenci pomocí streamu

Tato metoda používá přetížení Viewer.SetLicensePlugin(Stream pluginLicence) k přidání pluginové licence pomocí streamu.

C#
using (var pluginLicenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open))
{
    Viewer.SetLicensePlugin(pluginLicenseStream);
}

Přidat pluginovou licenci pomocí XML dokumentu

Tato metoda používá přetížení Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) k přidání pluginové licence pomocí XML dokumentu.

C#
var pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
Viewer.SetLicensePlugin(pluginXmlDoc);

Požadované balíčky NuGet

Aby byl váš projekt plně kompatibilní s .NET Core Standard, je třeba zahrnout následující balíčky NuGet, 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 vykreslování

Můžete konfigurovat chování vykreslová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í vykreslování

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

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

Jak přidat anotaci obrázku

V C#

1. Otevřete dokument a získejte rozměry první stránky. 2. Inicializujte AnnotationManager s rozměry stránky. 3. Vytvořte ImageAnnotation, nastavte cestu k obrázku v imgUrl a určete pozici a velikost v Rectangle. 4. Přidejte anotaci do správce a načtěte ji v prohlížeči dokumentu pro zobrazení.

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

var firstPage = docViewer.GetThumbnailDimensions(1, 0, 100, false);
var pageWidth = firstPage.Width;
var pageHeight = firstPage.Height;

using (var annMgr = docViewer.GetAnnotationManager(pageWidth, pageHeight))
{
    string imgUrl = "img/sample.png";
    var imgAnn = new ImageAnnotation(
        1,
        new Rectangle(600, 700, 750, 300),
        imgUrl
    );

    annMgr.Add(imgAnn);
    docViewer.LoadAnnotationXML(annMgr.GetAnnotationXml());
}

V JavaScriptu

1. Ujistěte se, že YourController je k dispozici. 2. Vytvořte novou ImageAnnotation, nastavte cestu k obrázku pomocí SetNote. 3. Přidejte a vykreslete anotaci, aby se zobrazila v dokumentu.

JavaScript
function ImageStamp() {
    if (null != objctlDoc.YourController()) {
        var objStampImage = new ImageAnnotation({ left: 200, top: 200, width: 260, height: 55 });
        objctlDoc.YourController().AddAnnotation(null, objStampImage, null);

        objStampImage.SetNote('/images/Approved_Stamp.png');
        objStampImage.Paint();
    }
}

Vlastní písma ve Word dokumentech

Vlastnost FontFolders ve třídě WordConfig určuje vlastní adresáře, kde bude aplikace hledat písma. To je zvláště užitečné při zpracování Word dokumentů, které spoléhají na písma, jež nejsou nainstalována ve výchozích adresářích písma systému.

Usage
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 e‑mailu, tak těla.

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

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

Podpora kultury pro Word Viewer

Vlastnost DocumentCulture ve třídě WordConfig vám umožňuje explicitně definovat kulturu pro soubory DOC a DOCX. To zajišťuje, že lokalizovaný obsah – například data, měny a čísla – se zobrazí přesně tak, jak to dělá Microsoft Word. To je zvláště užitečné pro jazyky s konkrétními požadavky na formátování.

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