Comment mettre à jour Doconut

Framework .NET 4.7

Configuration Web.config

Le visualiseur nécessite l'enregistrement d'HttpHandler via le fichier web.config. Selon votre version d'IIS, cela peut être fait en utilisant la section suivante définie dans web.config.

IIS 7 et versions antérieures :

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

IIS 7 et versions supérieures :

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

Mettre à jour l'enregistrement dans les pages ASPX

Modifiez l'enregistrement de l'assembly dans vos pages ASPX.

Ancien :

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

Nouveau :

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

Mettre à jour la balise de contrôle

Mettez à jour la balise de contrôle de DocViewer à Viewer.

Ancien :

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

Nouveau :

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

Mettre à jour les espaces de noms

Doconut 24.3.0 a renommé les espaces de noms. Ajoutez les nouvelles DLL : Doconut.dll, Doconut.Formats.dll, Doconut.Configs.dll et Doconut.Clouds.dll.

Nouveaux using :

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

Initialisation :

var viewer = new Viewer();

Dépendances du package

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

Standard .NET / Core

Mettre à jour les espaces de noms

Doconut 24.3.0 a renommé les espaces de noms. Ajoutez les nouvelles DLL : Doconut.dll, Doconut.Formats.dll, Doconut.Configs.dll et Doconut.Clouds.dll.

Nouveaux using :

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

Initialisation :

using System;

// Les instances de Viewer sont maintenant obtenues à partir d'une usine, d'un conteneur DI ou d'un autre fournisseur.
// Remplacez l'implémentation de GetViewer par votre logique d'acquisition réelle.
Viewer GetViewer() => throw new NotImplementedException();

var viewer = GetViewer(); // obtenir une instance de Viewer

Dépendances du package

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

.NET 6 ou supérieur

Mettre à jour les espaces de noms

Doconut 24.3.0 a renommé les espaces de noms. Ajoutez les nouvelles DLL : Doconut.dll, Doconut.Formats.dll, Doconut.Configs.dll et Doconut.Clouds.dll.

Nouveaux using :

// Intégration actuelle de .NET 6 : Viewer provient de DI et l'ouverture du document est asynchrone.
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { AllowSearch = true });

Initialisation :

app.MapPost("/api/open", async (Viewer viewer) =>
{
    // Le jeton est opaque — remettez-le au widget, ne le consignez ni ne le persistez jamais.
    string token = await viewer.OpenDocumentAsync("wwwroot/files/Sample.pdf");
    return Results.Ok(new { token });
});

Dépendances du package

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