הגדרה ב-.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. זה מבטיח שתוכן ממוקם — כגון תאריכים, מטבעות ומספרים — יוצג בדיוק כפי שהוא במיקרוסופט וורד. זה שימושי במיוחד לשפות עם דרישות עיצוב ספציפיות.

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)