У вас буде самостійно розгорнутий, блискавично швидкий переглядач документів, що працює у вашому застосунку .NET

Після завершення цього посібника ви зможете відкривати PDF, файли Office, креслення CAD та десятки інших форматів безпосередньо в браузері, з часом завантаження менше секунди, без зовнішніх SaaS‑викликів і з повним контролем над безпекою.

Передумови

Що потрібно	Навіщо це важливо
.NET 6 або новіша (SDK орієнтується на .NET 6+)	Забезпечує сумісність з SDK Online Document Viewer
Windows‑ або Linux‑сервер, на якому можна запускати ваш застосунок (власна інфраструктура або приватне хмара)	Самостійне розгортання вимагає, щоб переглядач працював у вашій інфраструктурі
Доступ до NuGet‑стрічки Online Document Viewer (https://doconut.com)	SDK розповсюджується у вигляді пакету NuGet
Базові знання ASP.NET Core і фронтенд‑JavaScript	Вам потрібно створити кінцеву точку, що повертає підписаний URL, і запустити переглядач у браузері
Сховище для вихідних файлів (файлова система, blob‑storage тощо)	Переглядач рендерить файли з локального або мережевого шляху; джерело має бути доступним процесу сервера

Відсутність будь‑якого з цих пунктів призведе до зупинки збірки ще до виконання першого рядка коду.

Встановіть SDK Online Document Viewer

Відкрийте рішення у Visual Studio або вашому улюбленому IDE та додайте офіційний SDK через менеджер NuGet:

dotnet add package Doconut.NET8

Пакет містить рушій рендерингу, конвертери форматів та тонкий HTTP‑шар, який обслуговує згенеровані сторінки. Оскільки SDK компілюється у ваш застосунок, під час виконання не звертаються до зовнішніх сервісів.

Після відновлення пакету зареєструйте сервіси SDK у Program.cs (або Startup.cs для старих шаблонів). Реєстрація впроваджує конвеєр рендерингу в DI‑контейнер ASP.NET Core, роблячи його доступним у ваших контролерах.

Налаштуйте конвеєр рендерингу для потрібних форматів

Переглядач підтримує понад 50 форматів «з коробки», зокрема:

PDF, DOC, DOCX, ODT, RTF
XLS, XLSX, CSV, ODS
PPT, PPTX, ODP
DWG, DXF, DGN (CAD)
PSD, SVG, TIFF, WEBP, ICO
EML, MSG, EPUB, MOBI, MPP, VSD

Коли надходить запит, SDK визначає тип файлу та обирає відповідний конвертер. Для кращої продуктивності увімкніть вбудований рівень кешування, який зберігає відрендерену сторінку в пам’яті протягом запиту; саме це забезпечує «Блискавично швидке – миттєве рендеринг документів з оптимізованою продуктивністю та завантаженням менше секунди» досвід.

У вашому контролері викличте метод рендерингу SDK (наприклад, RenderAsync) і передайте абсолютний шлях до вихідного файлу. Метод повертає HTML‑фрагмент, що містить переглядач на базі canvas. Оскільки рендеринг виконується на сервері, клієнт отримує лише готову до відображення розмітку, що усуває важку обробку на боці клієнта.

Захистіть переглядач за допомогою URL‑ів на основі токенів та додаткових обмежень

Суверенітет даних та відповідність GDPR – поширені питання для розгортань у власній інфраструктурі. SDK інтегрується з системою аутентифікації ASP.NET Core, дозволяючи генерувати підписаний токен, який надає одноразовий доступ до конкретного документу.

Типовий процес:

Фронтенд запитує ваш API про токен попереднього перегляду, передаючи ідентифікатор документу.
Ваш API перевіряє дозволи користувача, створює токен у стилі JWT, який кодує шлях до файлу та час закінчення, і повертає токен.
Фронтенд додає токен до URL переглядача (наприклад, /viewer?token=…). SDK перевіряє токен у кожному запиті та відхиляє будь‑який підроблений або прострочений токен.

Якщо потрібно заборонити користувачам завантаження або друк документу, налаштуйте параметри рендерингу, які надає SDK, щоб вимкнути ці дії. JavaScript‑шар переглядача тоді сховає кнопку «Завантажити», вимкне скорочення для друку та заблокує контекстне меню правої кнопки миші.

Перевірте, що все працює

Перейдіть на сторінку, що містить переглядач.
Документ має з’явитися протягом секунди, зі смугами прокрутки, елементами управління масштабом та полем пошуку.
Якщо ви вимкнули завантаження, кнопка «Завантажити» має бути схована.
Клік правою кнопкою миші по документу не повинен відкривати контекстне меню браузера, коли це обмеження ввімкнено.
Після закінчення терміну дії токену (за замовчуванням 5 хвилин) оновлення сторінки має повернути помилку «401 Неавторизовано», підтверджуючи активність перевірки токену.

Якщо будь‑яка з цих перевірок не проходить, поверніться до відповідного кроку: відсутня реєстрація SDK, неправильна генерація токену або пропущені прапорці безпеки.