Налаштування в .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, дозволяючи створювати об’єкт переглядача у вашому коді.

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)