Jak zaktualizować Doconut

.NET Framework 4.7

Konfiguracja Web.config

Podgląd wymaga zarejestrowania HttpHandler w pliku web.config. W zależności od wersji IIS można to zrobić przy użyciu następującej sekcji zdefiniowanej w web.config.

Poniżej IIS 7:

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

IIS 7 i wyżej:

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

Aktualizacja rejestracji w stronach ASPX

Zmień rejestrację zestawu w swoich stronach ASPX.

Stare:

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

Nowe:

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

Aktualizacja znacznika kontrolki

Zaktualizuj znacznik kontrolki z DocViewer na Viewer.

Stare:

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

Nowe:

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

Aktualizacja przestrzeni nazw

Doconut 24.3.0 zmienił nazwy przestrzeni nazw. Dodaj nowe pliki DLL: Doconut.dll, Doconut.Formats.dll, Doconut.Configs.dll i Doconut.Clouds.dll.

Nowe usingi:

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

Inicjalizacja:

var viewer = new Viewer();

Zależności pakietów

• Pakiet Newtonsoft.Json 13.0.3
• Pakiet System.Text.Encoding.CodePages 6.0.0
• Pakiet System.Text.Json 6.0.0

.NET Standard / Core

Aktualizacja przestrzeni nazw

Doconut 24.3.0 zmienił nazwy przestrzeni nazw. Dodaj nowe pliki DLL: Doconut.dll, Doconut.Formats.dll, Doconut.Configs.dll i Doconut.Clouds.dll.

Nowe usingi:

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

Inicjalizacja:

using System;

// Instancje Viewer są teraz pobierane z fabryki, kontenera DI lub innego dostawcy.
// Zastąp implementację GetViewer swoją rzeczywistą logiką pozyskiwania.
Viewer GetViewer() => throw new NotImplementedException();

var viewer = GetViewer(); // pobierz instancję Viewer

Zależności pakietów

• Pakiet Microsoft.Extensions.Caching.Abstractions 3.1.10
• Pakiet SkiaSharp 2.88.6
• Pakiet Newtonsoft.Json 13.0.3
• Pakiet System.Drawing.Common 6.0.0
• Pakiet System.Text.Json 6.0.0
• Pakiet System.Text.Encoding.CodePages 7.0.0

.NET 6 lub wyższy

Aktualizacja przestrzeni nazw

Doconut 24.3.0 zmienił nazwy przestrzeni nazw. Dodaj nowe pliki DLL: Doconut.dll, Doconut.Formats.dll, Doconut.Configs.dll i Doconut.Clouds.dll.

Nowe usingi:

// Aktualna integracja .NET 6: Viewer pochodzi z DI, a otwieranie dokumentu jest asynchroniczne.
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { AllowSearch = true });

Inicjalizacja:

app.MapPost("/api/open", async (Viewer viewer) =>
{
    // Token jest nieprzezroczysty — przekaż go do widgetu, nigdy nie loguj ani nie przechowuj go.
    string token = await viewer.OpenDocumentAsync("wwwroot/files/Sample.pdf");
    return Results.Ok(new { token });
});

Zależności pakietów

• Pakiet Microsoft.Extensions.Caching.Abstractions 3.1.10
• Pakiet Newtonsoft.Json 13.0.3
• Pakiet SkiaSharp 2.88.6
• Pakiet System.Drawing.Common 7.0.0
• Pakiet System.Text.Encoding.CodePages 7.0.0