Installation 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 assurer la compatibilité avec Doconut et .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 est pleinement compatible avec Doconut et .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 du 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 dans la classe WordConfig spécifie les 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 afin d’améliorer la compatibilité. AjaxControlToolkit ne sera plus inclus. Les utilisateurs sont invités à installer manuellement AjaxControlToolkit version 4.1.50508 dans leurs projets.

Mise à jour importante pour Doconut 25.2.0

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

Encodage des e‑mails

La propriété EmailEncoding dans la classe EmailConfig spécifie l’encodage préféré tant pour l’objet que pour le corps du courriel.

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

Encodage de l’objet et du corps

Les propriétés SubjectEncoding et BodyEncoding dans la classe EmailConfig définissent l’encodage utilisé respectivement pour l’objet 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
};