Einrichtung in .NET Framework

Web.config-Konfiguration

Registrieren Sie den HttpHandler in Ihrer web.config-Datei.

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>

Lizenzen hinzufügen

Doconut erkennt automatisch Lizenzen im Stammordner, oder Sie können sie manuell hinzufügen.

Manual License Path

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

Konfiguration für web.config

Die folgenden Konfigurationseinträge sind für die web.config-Datei erforderlich, um die Kompatibilität mit Doconut und dem .NET Framework sicherzustellen.

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>

Erforderliche NuGet-Pakete

Um sicherzustellen, dass Ihr Projekt vollständig mit Doconut und dem .NET Framework kompatibel ist, müssen die folgenden NuGet-Pakete eingebunden werden:

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

Render-Konfigurationsoptionen

Sie können das Renderverhalten mit den folgenden Optionen konfigurieren:

CadConfig: Wird für DWG-, DXF- und DGN-Dateien verwendet.
EmailConfig: Wird für EML-, EMLX- und MSG-Dateien verwendet.
EpubConfig: Wird für EPUB-Dateien verwendet.
ExcelConfig: Wird für Excel- und CSV-Dateien verwendet.
MhtConfig: Wird für MHT-Dateien verwendet.
PptConfig: Wird für PowerPoint-Dateien verwendet.
ProjectConfig: Wird für MPP-Dateien verwendet.
PsdConfig: Wird für PSD-Dateien verwendet.
TxtConfig: Wird für TXT-Dateien verwendet.
TiffConfig: Wird für TIFF-Dateien verwendet.

Example usage

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

Benutzerdefinierte Schriftarten in Word-Dokumenten

Die FontFolders-Eigenschaft in der WordConfig-Klasse gibt benutzerdefinierte Verzeichnisse an, in denen die Anwendung nach Schriftarten sucht.

Usage

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

Aktualisierung bezüglich AjaxControlToolkit im NuGet-Paket

Wir haben Änderungen an unserem NuGet-Paket vorgenommen, um die Kompatibilität zu verbessern. AjaxControlToolkit wird nicht mehr enthalten sein. Benutzern wird empfohlen, AjaxControlToolkit Version 4.1.50508 manuell in ihre Projekte zu installieren.

Wichtige Aktualisierung für Doconut 25.2.0

Es ist unerlässlich, das System.Text.Json-Paket in allen Ihren Projekten auf Version 8.0.5 zu aktualisieren.

E-Mail-Codierung

Die EmailEncoding-Eigenschaft in der EmailConfig-Klasse gibt die bevorzugte Codierung für Betreff und Text der E‑Mail an.

Usage

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

Betreff‑ und Textcodierung

Die Eigenschaften SubjectEncoding und BodyEncoding in der EmailConfig-Klasse definieren die jeweils für den Betreff und den Text einer E‑Mail verwendete Codierung.

Usage

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

Unterstützung der Kultur im Word Viewer

Die DocumentCulture-Eigenschaft in der WordConfig-Klasse ermöglicht es Ihnen, die Kultur für DOC- und DOCX-Dateien explizit festzulegen. Dadurch wird sichergestellt, dass lokalisierte Inhalte – wie Datumsangaben, Währungen und Zahlen – exakt so dargestellt werden wie in Microsoft Word. Dies ist besonders nützlich für Sprachen mit spezifischen Formatierungsanforderungen.

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)