الإعداد في .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)