Como Atualizar Doconut

Framework .NET 4.7

Configuração do Web.config

O visualizador requer que o HttpHandler seja registrado via arquivo web.config. Dependendo da sua versão do IIS, isso pode ser feito usando a seção a seguir definida no web.config.

Abaixo do IIS 7:

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

IIS 7 e superior:

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

Atualizar Registro em páginas ASPX

Altere o registro do assembly nas suas páginas ASPX.

Antigo:

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

Novo:

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

Atualizar Tag de Controle

Atualize a tag de controle de DocViewer para Viewer.

Antigo:

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

Novo:

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

Atualizar Namespaces

Doconut 24.3.0 renomeou os namespaces. Adicione os novos DLLs: Doconut.dll, Doconut.Formats.dll, Doconut.Configs.dll e Doconut.Clouds.dll.

Novos Usings:

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

Inicialização:

var viewer = new Viewer();

Dependências de Pacote

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

Standard .NET / Core

Atualizar Namespaces

Doconut 24.3.0 renomeou os namespaces. Adicione os novos DLLs: Doconut.dll, Doconut.Formats.dll, Doconut.Configs.dll e Doconut.Clouds.dll.

Novos Usings:

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

Inicialização:

using System;

// Instâncias de Viewer agora são obtidas de uma fábrica, DI container, ou outro provedor.
// Substitua a implementação de GetViewer pela sua lógica real de aquisição.
Viewer GetViewer() => throw new NotImplementedException();

var viewer = GetViewer(); // obter uma instância de Viewer

Dependências de Pacote

• Biblioteca 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 ou superior

Atualizar Namespaces

Doconut 24.3.0 renomeou os namespaces. Adicione os novos DLLs: Doconut.dll, Doconut.Formats.dll, Doconut.Configs.dll e Doconut.Clouds.dll.

Novos Usings:

// Integração atual do .NET 6: Viewer vem do DI e a abertura de documentos é assíncrona.
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { AllowSearch = true });

Inicialização:

app.MapPost("/api/open", async (Viewer viewer) =>
{
    // O token é opaco — entregue-o ao widget, nunca registre ou persista‑o.
    string token = await viewer.OpenDocumentAsync("wwwroot/files/Sample.pdf");
    return Results.Ok(new { token });
});

Dependências de Pacote

• 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