كيفية تحديث Doconut

إطار .NET 4.7

تكوين Web.config

يتطلب العارض تسجيل HttpHandler عبر ملف web.config. اعتمادًا على إصدار IIS الخاص بك، يمكن القيام بذلك باستخدام القسم التالي المحدد في web.config.

أقل من IIS 7:

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

IIS 7 وما فوق:

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

تحديث التسجيل في صفحات ASPX

غيّر تسجيل التجميع في صفحات ASPX الخاصة بك.

القديم:

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

الجديد:

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

تحديث علامة التحكم

قم بتحديث علامة التحكم من DocViewer إلى Viewer.

القديم:

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

الجديد:

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

تحديث المساحات الاسمية

قامت Doconut 24.3.0 بإعادة تسمية المساحات الاسمية. أضف ملفات DLL الجديدة: Doconut.dll، Doconut.Formats.dll، Doconut.Configs.dll، و Doconut.Clouds.dll.

الاستخدامات الجديدة:

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

التهيئة:

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.

الاستخدامات الجديدة:

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

التهيئة:

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.

الاستخدامات الجديدة:

// التكامل الحالي مع .NET 6: يأتي Viewer من DI وفتح المستند يتم بصورة غير متزامنة.
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { AllowSearch = true });

التهيئة:

app.MapPost("/api/open", async (Viewer viewer) =>
{
    // الرمز المميز غير شفاف — قدّمه إلى widget، ولا تسجّله أو تحتفظ به أبداً.
    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