نحوه به‌روزرسانی Doconut

این مراحل را برای به‌روزرسانی از نسخه 1.0.5.2 یا پایین‌تر دنبال کنید.

.NET چارچوب 4.7

پیکربندی Web.config

نمایشگر نیاز دارد HttpHandler از طریق فایل web.config ثبت شود. بسته به نسخه IIS شما می‌توان این کار را با استفاده از بخش زیر تعریف‌شده در web.config انجام داد.

در زیر IIS 7:

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

IIS 7 و بالاتر:

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

به‌روزرسانی ثبت‌نام در صفحات ASPX

ثبت اسمبلی را در صفحات ASPX خود تغییر دهید.

قدیم:

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

جدید:

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

به‌روزرسانی برچسب کنترل

برچسب کنترل را از DocViewer به Viewer به‌روزرسانی کنید.

قدیم:

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

جدید:

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

به‌روزرسانی فضاهای نام

در نسخه Doconut 24.3.0 فضاهای نام تغییر نام یافتند. DLLهای جدید را اضافه کنید: Doconut.dll، Doconut.Formats.dll، Doconut.Configs.dll، و Doconut.Clouds.dll.

استفاده‌های جدید:

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

راه‌اندازی:

csharp
var viewer = new Viewer();

وابستگی‌های بسته

  • پکیج Newtonsoft.Json 13.0.3
  • پکیج System.Text.Encoding.CodePages 6.0.0
  • پکیج System.Text.Json 6.0.0

.NET استاندارد / هسته

به‌روزرسانی فضاهای نام

در نسخه Doconut 24.3.0 فضاهای نام تغییر نام یافتند. DLLهای جدید را اضافه کنید: Doconut.dll، Doconut.Formats.dll، Doconut.Configs.dll، و Doconut.Clouds.dll.

استفاده‌های جدید:

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

راه‌اندازی:

csharp
using System;

// نمونه‌های Viewer اکنون از یک کارخانه، کانتینر DI یا ارائه‌دهندهٔ دیگر به‌دست می‌آیند.
// پیاده‌سازی GetViewer را با منطق واقعی به‌دست‌آوردن خود جایگزین کنید.
Viewer GetViewer() => throw new NotImplementedException();

var viewer = GetViewer(); // دریافت یک نمونه Viewer

وابستگی‌های بسته

  • پکیج 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 یا بالاتر

به‌روزرسانی فضاهای نام

در نسخه Doconut 24.3.0 فضاهای نام تغییر نام یافتند. DLLهای جدید را اضافه کنید: Doconut.dll، Doconut.Formats.dll، Doconut.Configs.dll، و Doconut.Clouds.dll.

استفاده‌های جدید:

csharp
// یکپارچه‌سازی فعلی .NET 6: Viewer از DI می‌آید و باز کردن سند به صورت ناهمزمان است.
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { AllowSearch = true });

راه‌اندازی:

csharp
app.MapPost("/api/open", async (Viewer viewer) =>
{
    // توکن نامشخص است — آن را به ویجت بدهید، هرگز لاگ نکنید یا ذخیره نکنید.
    string token = await viewer.OpenDocumentAsync("wwwroot/files/Sample.pdf");
    return Results.Ok(new { token });
});

وابستگی‌های بسته

  • پکیج 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

آیا این صفحه مفید بود؟