.NET Standard / Core のセットアップ

Startup.cs ファイル

.NET Core プロジェクトの Startup.cs ファイル内で、これらのコード行は MapWhen メソッドを使用したミドルウェア パイプライン構成を定義します。 提供された述語は、受信リクエスト パスが DocImage.axd で終わるかどうかをチェックします。このブロック内では、UseDoconut メソッドが DoconutOptions オブジェクトを引数として呼び出されます。

app.MapWhen(
    context => context.Request.Path.ToString().EndsWith("DocImage.axd"),
    appBranch =>
    {
        appBranch.UseDoconut(new DoconutOptions { UnSafeMode = false, ShowDoconutInfo = false });
    }
);

Doconut 名前空間の追加

プロジェクトに以下の using ステートメントを追加します。

using Doconut;
using Doconut.Configs;
using Doconut.Formats;
using Doconut.Clouds;

Viewer オブジェクトのインスタンス化

この行は Viewer クラスの新しいインスタンスを生成し、コード内で viewer オブジェクトを作成できるようにします。

var docViewer = new Viewer(_cache, _accessor, licenseFilePath);

DocOptions オブジェクトの設定

特定の構成で DocOptions オブジェクトを初期化する例：

var documentOptions = new DocOptions
{
    Password = "",
    ImageResolution = 200,
    TimeOut = 30
};

config オブジェクトの設定

PDF ドキュメントを処理するための特定の構成で新しい PdfConfig オブジェクトを初期化します。

var config = new PdfConfig { DefaultRender = true, ExtractHyperlinks = true };

ドキュメントを開く

この行は viewer オブジェクトの OpenDocument メソッドを呼び出し、サーバー上のドキュメント ファイルのパスと、事前に設定した PdfConfig および DocOptions オブジェクトをパラメータとして渡します。

var token = docViewer.OpenDocument(pathToFile, config, documentOptions);

HTML に viewer を追加

<div id="div_ctlDoc"></div>

CSS と JavaScript ファイルの追加

ページに以下の CSS と JavaScript ファイルを追加します。これらのスクリプトはコードサンプルが含まれた ZIP ファイルに同梱されています。

<link rel="stylesheet" href="css/viewer.css" />

<!-- Main Viewer Related Scripts -->
<script src="scripts/jquery.min.js"></script>
<script src="scripts/docViewer.js"></script>
<script src="scripts/splitter.js"></script>
<script src="scripts/search.js"></script>
<script src="scripts/documentLinks.js"></script>

<!-- Viewer functions -->
<script src="scripts/docViewer.UI.js?v=1"></script>

必須 NuGet パッケージ

.NET Core Standard と完全に互換性を保つため、次の NuGet パッケージをアルファベット順で含める必要があります。

• MessagePack - Version 2.5.140
• Microsoft.Bcl.AsyncInterfaces - Version 8.0.0
• Microsoft.Extensions.Caching.Abstractions - Version 8.0.0
• Microsoft.Extensions.Configuration - Version 8.0.0
• Microsoft.Extensions.Configuration.Abstractions - Version 8.0.0
• Microsoft.Extensions.Configuration.FileExtensions - Version 8.0.0
• Microsoft.Extensions.Configuration.Json - Version 8.0.0
• Microsoft.Extensions.FileProviders.Abstractions - Version 8.0.0
• Microsoft.Extensions.FileProviders.Physical - Version 8.0.0
• Microsoft.Extensions.FileSystemGlobbing - Version 8.0.0
• Microsoft.Extensions.Primitives - Version 8.0.0
• System.Buffers - Version 4.5.1
• System.Formats.Asn1 - Version 8.0.0
• System.Numerics.Vectors - Version 4.5.0
• System.Security.Cryptography.Cng - Version 5.0.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
• System.Threading.Tasks.Extensions - Version 4.5.4

レンダリング構成オプション

以下のオプションを使用してレンダリング動作を構成できます。

• 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 ファイルに使用します。

レンダーオプション設定

レンダーオプションは DefaultRender プロパティで設定されます。

• DefaultRender = true : このオプションは高品質のレンダリングを提供しますが、サーバーのメモリと処理時間を多く使用します。
• DefaultRender = false : このオプションは若干品質が低下する代わりに、より高速なレンダリングを提供します。

Word ドキュメントでのカスタムフォント

WordConfig クラスの FontFolders プロパティは、アプリケーションがフォントを検索するカスタムディレクトリを指定します。これは、システムのデフォルト フォント ディレクトリにインストールされていないフォントに依存する Word ドキュメントを処理する際に特に有用です。

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

Doconut 25.2.0 の重要な更新

すべてのプロジェクトで System.Text.Json パッケージをバージョン 8.0.5 に更新することが必須です。この更新により、最新機能との互換性が確保され、重要なセキュリティ改善が行われます。

メールエンコーディング

EmailConfig クラスの EmailEncoding プロパティは、メールの件名と本文の両方に使用するエンコーディングを指定します。

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

件名と本文のエンコーディング

EmailConfig クラスの SubjectEncoding と BodyEncoding プロパティは、それぞれメールの件名と本文に使用されるエンコーディングを定義します。

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

Word ビューアのカルチャーサポート

WordConfig クラスの DocumentCulture プロパティにより、DOC および DOCX ファイルのカルチャーを明示的に定義できます。これにより、日付、通貨、数値などのローカライズされたコンテンツが Microsoft Word と同様に正確に表示されます。特に特定の書式設定要件を持つ言語に便利です。

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)

必要な CSS と JS ファイルのダウンロード

Doconut が正しく動作するために、プロジェクトに特定の CSS と JS ファイルを含める必要があります。以下のリンクから、必要なすべてのファイルが入った ZIP ファイルをダウンロードできます。