הגדרה ב-.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 Viewer

המאפיין 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)