Налаштування в .NET 6 або вище

Файл 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‑файл з прикладами коду.

<!-- Main Viewer Related Scripts -->
<script src="scripts/splitter.js"></script>
<script src="scripts/docViewer.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

Властивість 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)