Cách Cập Nhật Doconut

.NET Khung 4.7

Cấu hình Web.config

Trình xem yêu cầu HttpHandler được đăng ký qua tệp web.config. Tùy thuộc vào phiên bản IIS của bạn, việc này có thể thực hiện bằng phần sau được định nghĩa trong web.config.

Dưới IIS 7:

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

IIS 7 và các phiên bản cao hơn:

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

Cập nhật đăng ký trong các trang ASPX

Thay đổi việc đăng ký assembly trong các trang ASPX của bạn.

Cũ:

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

Mới:

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

Cập nhật thẻ điều khiển

Cập nhật thẻ điều khiển từ DocViewer sang Viewer.

Cũ:

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

Mới:

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

Cập nhật Namespaces

Doconut 24.3.0 đã đổi tên các namespace. Thêm các DLL mới: Doconut.dll, Doconut.Formats.dll, Doconut.Configs.dll và Doconut.Clouds.dll.

Các using mới:

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

Khởi tạo:

var viewer = new Viewer();

Các phụ thuộc gói

• Gói Newtonsoft.Json 13.0.3
• Gói System.Text.Encoding.CodePages 6.0.0
• Gói System.Text.Json 6.0.0

.NET Chuẩn / Cốt lõi

Cập nhật Namespaces

Doconut 24.3.0 đã đổi tên các namespace. Thêm các DLL mới: Doconut.dll, Doconut.Formats.dll, Doconut.Configs.dll và Doconut.Clouds.dll.

Các using mới:

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

Khởi tạo:

using System;

// Các thể hiện Viewer hiện được lấy từ một factory, container DI, hoặc nhà cung cấp khác.
// Thay thế triển khai của GetViewer bằng logic thu thập thực tế của bạn.
Viewer GetViewer() => throw new NotImplementedException();

var viewer = GetViewer(); // lấy một thể hiện Viewer

Các phụ thuộc gói

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

.NET 6 hoặc cao hơn

Cập nhật Namespaces

Doconut 24.3.0 đã đổi tên các namespace. Thêm các DLL mới: Doconut.dll, Doconut.Formats.dll, Doconut.Configs.dll và Doconut.Clouds.dll.

Các using mới:

// Tích hợp .NET 6 hiện tại: Viewer được lấy từ DI và việc mở tài liệu là bất đồng bộ.
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { AllowSearch = true });

Khởi tạo:

app.MapPost("/api/open", async (Viewer viewer) =>
{
    // Token là không trong suốt — đưa nó cho widget, không bao giờ ghi log hoặc lưu trữ nó.
    string token = await viewer.OpenDocumentAsync("wwwroot/files/Sample.pdf");
    return Results.Ok(new { token });
});

Các phụ thuộc gói

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