Configuration dans .NET Framework

Configuration Web.config

Enregistrez le HttpHandler dans votre fichier 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>

Ajouter des licences

Doconut détecte automatiquement les licences dans le dossier racine, ou vous pouvez les ajouter manuellement.

Manual License Path

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

Configuration pour web.config

Les entrées de configuration suivantes sont nécessaires dans le fichier web.config pour garantir la compatibilité avec Doconut et le .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>

Packages NuGet requis

Pour garantir que votre projet soit entièrement compatible avec Doconut et le .NET Framework, les packages NuGet suivants doivent être inclus :

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

Options de configuration du rendu

Vous pouvez configurer le comportement de rendu à l’aide des options suivantes :

CadConfig : utilisé pour les fichiers DWG, DXF et DGN.
EmailConfig : utilisé pour les fichiers EML, EMLX et MSG.
EpubConfig : utilisé pour les fichiers EPUB.
ExcelConfig : utilisé pour les fichiers Excel et CSV.
MhtConfig : utilisé pour les fichiers MHT.
PptConfig : utilisé pour les fichiers PowerPoint.
ProjectConfig : utilisé pour les fichiers MPP.
PsdConfig : utilisé pour les fichiers PSD.
TxtConfig : utilisé pour les fichiers TXT.
TiffConfig : utilisé pour les fichiers TIFF.

Example usage

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

Polices personnalisées dans les documents Word

La propriété FontFolders de la classe WordConfig spécifie des répertoires personnalisés où l’application recherchera les polices.

Usage

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

Mise à jour concernant AjaxControlToolkit dans le package NuGet

Nous avons apporté des modifications à notre package NuGet pour améliorer la compatibilité. AjaxControlToolkit ne sera plus inclus. Nous recommandons aux utilisateurs d’installer manuellement la version 4.1.50508 d’AjaxControlToolkit dans leurs projets.

Mise à jour importante pour Doconut 25.2.0

Il est essentiel de mettre à jour le package System.Text.Json vers la version 8.0.5 dans tous vos projets.

Encodage des e‑mails

La propriété EmailEncoding de la classe EmailConfig spécifie l’encodage préféré pour le sujet et le corps de l’e‑mail.

Usage

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

Encodage du sujet & du corps

Les propriétés SubjectEncoding et BodyEncoding de la classe EmailConfig définissent l’encodage utilisé respectivement pour le sujet et le corps d’un e‑mail.

Usage

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

Prise en charge de la culture du visualiseur Word

La propriété DocumentCulture de la classe WordConfig vous permet de définir explicitement la culture pour les fichiers DOC et DOCX. Cela garantit que le contenu localisé — comme les dates, les devises et les nombres — s’affiche exactement comme dans Microsoft Word. Cette fonctionnalité est particulièrement utile pour les langues ayant des exigences de formatage spécifiques.

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)