الإعداد في .NET Framework

تكوين Web.config

سجِّل HttpHandler في ملف web.config الخاص بك.

Below IIS 7

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

IIS 7 and above

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

إضافة تراخيص

Doconut يكتشف التراخيص تلقائيًا في المجلد الجذر، أو يمكنك إضافتها يدويًا.

Manual License Path

var licenseFilePath = Server.MapPath("~/Doconut.Viewer.lic");
var docViewer = new Viewer(licenseFilePath);

التكوين لـ web.config

القيم التالية في تكوين web.config ضرورية لضمان التوافق مع Doconut و .NET Framework.

web.config

<configuration>
  <runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <dependentAssembly>
        <assemblyIdentity name="System.Memory" publicKeyToken="cc7b13ffcd2ddd51" culture="neutral" />
        <bindingRedirect oldVersion="0.0.0.0-4.0.1.2" newVersion="4.0.1.2" />
      </dependentAssembly>
      <dependentAssembly>
        <assemblyIdentity name="System.Text.Encodings.Web" publicKeyToken="cc7b13ffcd2ddd51" culture="neutral" />
        <bindingRedirect oldVersion="0.0.0.0-8.0.0.0" newVersion="8.0.0.0" />
      </dependentAssembly>
      <dependentAssembly>
        <assemblyIdentity name="System.Text.Encoding.CodePages" publicKeyToken="b03f5f7f11d50a3a" culture="neutral" />
        <bindingRedirect oldVersion="0.0.0.0-8.0.0.0" newVersion="8.0.0.0" />
      </dependentAssembly>
      <dependentAssembly>
        <assemblyIdentity name="System.Text.Json" publicKeyToken="cc7b13ffcd2ddd51" culture="neutral" />
        <bindingRedirect oldVersion="0.0.0.0-6.0.0.0" newVersion="8.0.3.0" />
      </dependentAssembly>
      <dependentAssembly>
        <assemblyIdentity name="Microsoft.Bcl.AsyncInterfaces" publicKeyToken="cc7b13ffcd2ddd51" culture="neutral" />
        <bindingRedirect oldVersion="0.0.0.0-8.0.0.0" newVersion="8.0.0.0" />
      </dependentAssembly>
      <dependentAssembly>
        <assemblyIdentity name="System.Drawing.Common" publicKeyToken="cc7b13ffcd2ddd51" culture="neutral" />
        <bindingRedirect oldVersion="0.0.0.0-6.0.0.0" newVersion="6.0.0.0" />
      </dependentAssembly>
      <dependentAssembly>
        <assemblyIdentity name="MessagePack" publicKeyToken="9c7f9b36b37eaddf" culture="neutral" />
        <bindingRedirect oldVersion="0.0.0.0-2.5.140.0" newVersion="2.5.140.0" />
      </dependentAssembly>
      <dependentAssembly>
        <assemblyIdentity name="System.Buffers" publicKeyToken="cc7b13ffcd2ddd51" culture="neutral" />
        <bindingRedirect oldVersion="0.0.0.0-4.0.3.0" newVersion="4.0.3.0" />
      </dependentAssembly>
      <dependentAssembly>
        <assemblyIdentity name="System.Numerics.Vectors" publicKeyToken="b03f5f7f11d50a3a" culture="neutral" />
        <bindingRedirect oldVersion="0.0.0.0-4.1.3.0" newVersion="4.1.4.0" />
      </dependentAssembly>
    </assemblyBinding>
  </runtime>
</configuration>

حزم NuGet المطلوبة

لضمان توافق مشروعك بالكامل مع Doconut و .NET Framework، يجب تضمين حزم NuGet التالية:

MessagePack - Version 2.5.140
MessagePack.Annotations - Version 2.5.140
Microsoft.Bcl.AsyncInterfaces - Version 8.0.0
Microsoft.NET.StringTools - Version 17.6.3
System.Collections.Immutable - Version 6.0.0
System.Drawing.Common - Version 6.0.0
System.Memory - Version 4.5.5
System.Reflection.Emit - Version 4.7.0
System.Reflection.Emit.Lightweight - Version 4.7.0
System.Security.Cryptography.Pkcs - Version 8.0.0
System.Text.Encoding.CodePages - Version 8.0.0
System.Text.Encodings.Web - Version 8.0.0
System.Text.Json - Version 8.0.3

خيارات تكوين العرض

يمكنك تكوين سلوك العرض باستخدام الخيارات التالية:

CadConfig: يستخدم لملفات DWG وDXF وDGN.
EmailConfig: يستخدم لملفات EML وEMLX وMSG.
EpubConfig: يستخدم لملفات EPUB.
ExcelConfig: يستخدم لملفات Excel وCSV.
MhtConfig: يستخدم لملفات MHT.
PptConfig: يستخدم لملفات PowerPoint.
ProjectConfig: يستخدم لملفات MPP.
PsdConfig: يستخدم لملفات PSD.
TxtConfig: يستخدم لملفات TXT.
TiffConfig: يستخدم لملفات TIFF.

Example usage

var config = new CadConfig { DefaultRender = false }; // or true

خطوط مخصصة في مستندات Word

تحدد الخاصية FontFolders في فئة WordConfig الدلائل المخصصة التي سيبحث فيها التطبيق عن الخطوط.

Usage

var config = new WordConfig
{
    FontFolders = new string[] { "C:\\CustomFonts", "D:\\SharedFonts" }
};

تحديث بخصوص AjaxControlToolkit في حزمة NuGet

لقد أجرينا تغييرات على حزمة NuGet الخاصة بنا لتحسين التوافق. لن يتم تضمين AjaxControlToolkit بعد الآن. ينصح المستخدمون بتثبيت AjaxControlToolkit يدوياً بالإصدار 4.1.50508 في مشاريعهم.

تحديث مهم لـ Doconut 25.2.0

من الضروري تحديث حزمة System.Text.Json إلى الإصدار 8.0.5 في جميع مشاريعك.

تميز البريد الإلكتروني

تحدد الخاصية EmailEncoding في فئة EmailConfig الترميز المفضل لكل من موضوع البريد الإلكتروني's ومحتوىاه.

Usage

var emailConfig = new EmailConfig {
    EmailEncoding = Encoding.UTF8 // Set preferred email encoding
};

تميز الموضوع & النص

تحدد الخصائص SubjectEncoding و BodyEncoding في فئة EmailConfig الترميز المستخدم لموضوع البريد الإلكتروني's ومحتوى على التوالي.

Usage

var emailConfig = new EmailConfig {
    SubjectEncoding = Encoding.UTF8, // Set encoding for the subject
    BodyEncoding = Encoding.UTF8     // Set encoding for the body
};

دعم سقفة عارض Word

تسمح ميزة DocumentCulture في فئة WordConfig بتعريف السقفة بشكل صريح لملفات DOC و DOCX. هذا يضمن أن المحتوى المحلي — مثل التواريخ المالية والعملات وأرقام الأرقام — يتعرض كما في Microsoft Word. هذا من المفديج خاصة لللغات التي تحتاج إلى تنسيقات مخصصة.

Usage

var config = new WordConfig { DocumentCulture = "he-IL" }; // Hebrew (Israel)
var config = new WordConfig { DocumentCulture = "ar-SA" }; // Arabic (Saudi Arabia)
var config = new WordConfig { DocumentCulture = "th-TH" }; // Thai (Thailand)
var config = new WordConfig { DocumentCulture = "ja-JP" }; // Japanese (Japan)