Як оновити Doconut

.NET Фреймворк 4.7

Конфігурація Web.config

Переглядач потребує реєстрації HttpHandler у файлі web.config. Залежно від вашої версії IIS це можна зробити за допомогою наступного розділу, визначеного у web.config.

Нижче IIS 7:

<httpHandlers>
  <add verb="GET,POST" path="DocImage.axd" type="Doconut.DocImageHandler, Doconut" />
</httpHandlers>

IIS 7 і вище:

<handlers>
  <add name="DocImage" verb="GET,POST" path="DocImage.axd" type="Doconut.DocImageHandler, Doconut" />
</handlers>

Оновлення реєстрації у сторінках ASPX

Змініть реєстрацію збірки у ваших сторінках ASPX.

Старий:

<%@ Register Assembly="DocumentViewer" Namespace="DotnetDaddy.DocumentViewer" TagPrefix="asp" %>

Новий:

<%@ Register Assembly="Doconut" Namespace="Doconut" TagPrefix="asp" %>

Оновлення тегу керування

Оновіть тег керування з DocViewer на Viewer.

Старий:

<asp:DocViewer ID="ctlDoc" runat="server"/>

Новий:

<asp:Viewer ID="ctlDoc" runat="server"/>

Оновлення просторів імен

Doconut 24.3.0 перейменував простори імен. Додайте нові DLL: Doconut.dll, Doconut.Formats.dll, Doconut.Configs.dll та Doconut.Clouds.dll.

Нові using:

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

Ініціалізація:

var viewer = new Viewer();

Залежності пакету

• Пакет Newtonsoft.Json 13.0.3
• Пакет System.Text.Encoding.CodePages 6.0.0
• Пакет System.Text.Json 6.0.0

.NET Стандарт / Ядро

Оновлення просторів імен

Doconut 24.3.0 перейменував простори імен. Додайте нові DLL: Doconut.dll, Doconut.Formats.dll, Doconut.Configs.dll та Doconut.Clouds.dll.

Нові using:

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

Ініціалізація:

using System;

// Екземпляри Viewer тепер отримуються з фабрики, контейнера DI або іншого постачальника.
// Замініть реалізацію GetViewer на вашу фактичну логіку отримання.
Viewer GetViewer() => throw new NotImplementedException();

var viewer = GetViewer(); // отримати екземпляр Viewer

Залежності пакету

• Пакет Microsoft.Extensions.Caching.Abstractions 3.1.10
• Пакет SkiaSharp 2.88.6
• Пакет Newtonsoft.Json 13.0.3
• Пакет System.Drawing.Common 6.0.0
• Пакет System.Text.Json 6.0.0
• Пакет System.Text.Encoding.CodePages 7.0.0

.NET 6 або вище

Оновлення просторів імен

Doconut 24.3.0 перейменував простори імен. Додайте нові DLL: Doconut.dll, Doconut.Formats.dll, Doconut.Configs.dll та Doconut.Clouds.dll.

Нові using:

// Поточна інтеграція .NET 6: Viewer отримується з DI, а відкриття документа є асинхронним.
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { AllowSearch = true });

Ініціалізація:

app.MapPost("/api/open", async (Viewer viewer) =>
{
    // Токен є непрозорим — передайте його віджету, ніколи не журналюйте і не зберігайте його.
    string token = await viewer.OpenDocumentAsync("wwwroot/files/Sample.pdf");
    return Results.Ok(new { token });
});

Залежності пакету

• Пакет Microsoft.Extensions.Caching.Abstractions 3.1.10
• Пакет Newtonsoft.Json 13.0.3
• Пакет SkiaSharp 2.88.6
• Пакет System.Drawing.Common 7.0.0
• Пакет System.Text.Encoding.CodePages 7.0.0