Cómo actualizar Doconut

.NET Marco 4.7

Configuración de Web.config

El visor requiere que HttpHandler esté registrado mediante el archivo web.config. Dependiendo de su versión de IIS, puede hacerse usando la siguiente sección definida en web.config.

Por debajo de IIS 7:

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

IIS 7 y superiores:

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

Actualizar registro en páginas ASPX

Cambie el registro del ensamblado en sus páginas ASPX.

Antiguo:

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

Nuevo:

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

Actualizar etiqueta de control

Actualice la etiqueta de control de DocViewer a Viewer.

Antiguo:

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

Nuevo:

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

Actualizar espacios de nombres

Doconut 24.3.0 renombró los espacios de nombres. Añada los nuevos DLL: Doconut.dll, Doconut.Formats.dll, Doconut.Configs.dll y Doconut.Clouds.dll.

Nuevos Usings:

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

Inicialización:

var viewer = new Viewer();

Dependencias del paquete

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

.NET Estándar / Núcleo

Actualizar espacios de nombres

Doconut 24.3.0 renombró los espacios de nombres. Añada los nuevos DLL: Doconut.dll, Doconut.Formats.dll, Doconut.Configs.dll y Doconut.Clouds.dll.

Nuevos Usings:

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

Inicialización:

using System;

// Las instancias de Viewer ahora se obtienen de una fábrica, contenedor DI o otro proveedor.
// Reemplace la implementación de GetViewer con su lógica real de adquisición.
Viewer GetViewer() => throw new NotImplementedException();

var viewer = GetViewer(); // obtener una instancia de Viewer

Dependencias del paquete

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

.NET 6 o superior

Actualizar espacios de nombres

Doconut 24.3.0 renombró los espacios de nombres. Añada los nuevos DLL: Doconut.dll, Doconut.Formats.dll, Doconut.Configs.dll y Doconut.Clouds.dll.

Nuevos Usings:

// Integración actual de .NET 6: Viewer proviene de DI y la apertura del documento es asíncrona.
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { AllowSearch = true });

Inicialización:

app.MapPost("/api/open", async (Viewer viewer) =>
{
    // El token es opaco — páselo al widget, nunca lo registre ni lo persista.
    string token = await viewer.OpenDocumentAsync("wwwroot/files/Sample.pdf");
    return Results.Ok(new { token });
});

Dependencias del paquete

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