Installation i .NET Standard / Core

Startup.cs-fil

Inom Startup.cs-filen i ett .NET Core-projekt definierar dessa kodrader en konfiguration av middleware-pipelinen med hjälp av MapWhen‑metoden. Det angivna predikatet kontrollerar om den inkommande begärans sökväg slutar på DocImage.axd. Inuti detta block anropas UseDoconut‑metoden med ett DoconutOptions‑objekt som argument.

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

Lägg till Doconut-namnrymder

Lägg till följande using‑satser i ditt projekt:

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

Instansiera Viewer‑objekt

Denna rad skapar en ny instans av Viewer‑klassen, vilket gör att du kan skapa ett viewer‑objekt i din kod.

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

Skapa ett DocOptions‑objekt

Exempel på initiering av ett DocOptions‑objekt med specifika konfigurationer:

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

Skapa ett konfigurationsobjekt

Initiera ett nytt PdfConfig‑objekt med specifika konfigurationer för hantering av PDF‑dokument:

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

Öppna ditt dokument

Denna rad anropar OpenDocument‑metoden på viewer‑objektet och skickar sökvägen till dokumentfilen som ligger på servern samt de tidigare konfigurerade PdfConfig‑ och DocOptions‑objekten som parametrar.

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

Lägg till viewer i din HTML

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

Lägg till CSS‑ och JavaScript‑filer

Lägg till följande CSS‑ och JavaScript‑filer på sidan. Dessa skript ingår i ZIP‑filen med kodexempel.

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

Nödvändiga NuGet‑paket

För att säkerställa att ditt projekt är fullt kompatibelt med .NET Core Standard måste följande NuGet‑paket inkluderas, listade i alfabetisk ordning.

• 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

Renderingskonfigurationsalternativ

Du kan konfigurera renderingsbeteendet med följande alternativ:

• CadConfig: Används för DWG-, DXF- och DGN-filer.
• EmailConfig: Används för EML-, EMLX- och MSG-filer.
• EpubConfig: Används för EPUB-filer.
• ExcelConfig: Används för Excel- och CSV-filer.
• MhtConfig: Används för MHT-filer.
• PptConfig: Används för PowerPoint-filer.
• ProjectConfig: Används för MPP-filer.
• PsdConfig: Används för PSD-filer.
• TxtConfig: Används för TXT-filer.
• TiffConfig: Används för TIFF-filer.

Konfiguration av renderingsalternativ

Renderingsalternativen konfigureras med hjälp av egenskapen DefaultRender:

• DefaultRender = true : Detta alternativ ger högre kvalitet på rendering men använder mer serverminne och bearbetningstid.
• DefaultRender = false : Detta alternativ ger snabbare rendering på bekostnad av något sänkt kvalitet.

Anpassade teckensnitt i Word-dokument

Egenskapen FontFolders i WordConfig‑klassen specificerar anpassade kataloger där applikationen kommer att söka efter teckensnitt. Detta är särskilt användbart för att behandla Word‑dokument som förlitar sig på teckensnitt som inte är installerade i systemets standardteckensnittskataloger.

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

Viktig uppdatering för Doconut 25.2.0

Det är viktigt att uppdatera System.Text.Json‑paketet till version 8.0.5 i alla dina projekt. Denna uppdatering är avgörande för att säkerställa kompatibilitet med de senaste funktionerna och för att åtgärda viktiga säkerhetsförbättringar.

E-post‑kodning

Egenskapen EmailEncoding i EmailConfig‑klassen specificerar den föredragna kodningen för både e-postens ämne och innehåll.

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

Kodning för ämne och innehåll

Egenskaperna SubjectEncoding och BodyEncoding i EmailConfig‑klassen definierar den kodning som används för respektive e-postens ämne och innehåll.

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

Ladda ner nödvändiga CSS‑ och JS‑filer

För att Doconut ska fungera korrekt måste du inkludera specifika CSS‑ och JS‑filer i ditt projekt. Du kan ladda ner en ZIP‑fil som innehåller alla nödvändiga filer via länken nedan: