Налаштування в .NET Standard / Core

Файл Startup.cs

У файлі Startup.cs проєкту .NET Core ці рядки коду визначають конфігурацію конвеєра проміжного програмного забезпечення за допомогою методу 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, що дозволяє створити об’єкт переглядача у вашому коді.

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

Налаштування об’єкта DocOptions

Приклад ініціалізації об’єкта DocOptions з конкретними налаштуваннями:

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

Налаштування об’єкта конфігурації

Ініціалізуйте новий об’єкт PdfConfig з конкретними налаштуваннями для обробки PDF‑документів:

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

Відкриття вашого документу

Цей рядок викликає метод OpenDocument об’єкта переглядача, передаючи шлях до файлу документа, розташованого на сервері, та раніше налаштовані об’єкти PdfConfig і DocOptions як параметри.

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

Додайте переглядач у ваш 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 - Версія 2.5.140
• Microsoft.Bcl.AsyncInterfaces - Версія 8.0.0
• Microsoft.Extensions.Caching.Abstractions - Версія 8.0.0
• Microsoft.Extensions.Configuration - Версія 8.0.0
• Microsoft.Extensions.Configuration.Abstractions - Версія 8.0.0
• Microsoft.Extensions.Configuration.FileExtensions - Версія 8.0.0
• Microsoft.Extensions.Configuration.Json - Версія 8.0.0
• Microsoft.Extensions.FileProviders.Abstractions - Версія 8.0.0
• Microsoft.Extensions.FileProviders.Physical - Версія 8.0.0
• Microsoft.Extensions.FileSystemGlobbing - Версія 8.0.0
• Microsoft.Extensions.Primitives - Версія 8.0.0
• System.Buffers - Версія 4.5.1
• System.Formats.Asn1 - Версія 8.0.0
• System.Numerics.Vectors - Версія 4.5.0
• System.Security.Cryptography.Cng - Версія 5.0.0
• System.Security.Cryptography.Pkcs - Версія 8.0.0
• System.Text.Encoding.CodePages - Версія 8.0.0
• System.Text.Encodings.Web - Версія 8.0.0
• System.Text.Json - Версія 8.0.3
• System.Threading.Tasks.Extensions - Версія 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‑документів, які покладаються на шрифти, не встановлені у стандартних системних каталогах.

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

Важливе оновлення для Doconut 25.2.0

Необхідно оновити пакет System.Text.Json до версії 8.0.5 у всіх ваших проєктах. Це оновлення критично важливе для забезпечення сумісності з останніми функціями та виправлення важливих проблем безпеки.

Кодування електронної пошти

Властивість EmailEncoding у класі EmailConfig визначає бажане кодування для теми та тіла листа.

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

Кодування теми та тіла

Властивості SubjectEncoding і BodyEncoding у класі EmailConfig визначають кодування, що використовується для теми та тіла електронного листа відповідно.

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

Підтримка культур у Word Viewer

Властивість DocumentCulture у класі WordConfig дозволяє явно задати культуру для файлів DOC і DOCX. Це гарантує, що локалізований вміст — дати, валюти, числа — відображається точно так само, як у Microsoft Word. Особливо корисно для мов зі специфічними вимогами до форматування.

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)