الإعداد في .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 تحدد الترميز المفضل لكل من موضوع البريد الإلكتروني ومحتواه.

Usage

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

ترميز الموضوع والمحتوى

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

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)