.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
};

設定オブジェクトのセットアップ

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

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

文書を開く

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

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

HTMLにビューアを追加する

<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 - バージョン 2.5.140
• Microsoft.Bcl.AsyncInterfaces - バージョン 8.0.0
• Microsoft.Extensions.Caching.Abstractions - バージョン 8.0.0
• Microsoft.Extensions.Configuration - バージョン 8.0.0
• Microsoft.Extensions.Configuration.Abstractions - バージョン 8.0.0
• Microsoft.Extensions.Configuration.FileExtensions - バージョン 8.0.0
• Microsoft.Extensions.Configuration.Json - バージョン 8.0.0
• Microsoft.Extensions.FileProviders.Abstractions - バージョン 8.0.0
• Microsoft.Extensions.FileProviders.Physical - バージョン 8.0.0
• Microsoft.Extensions.FileSystemGlobbing - バージョン 8.0.0
• Microsoft.Extensions.Primitives - バージョン 8.0.0
• System.Buffers - バージョン 4.5.1
• System.Formats.Asn1 - バージョン 8.0.0
• System.Numerics.Vectors - バージョン 4.5.0
• System.Security.Cryptography.Cng - バージョン 5.0.0
• System.Security.Cryptography.Pkcs - バージョン 8.0.0
• System.Text.Encoding.CodePages - バージョン 8.0.0
• System.Text.Encodings.Web - バージョン 8.0.0
• System.Text.Json - バージョン 8.0.3
• System.Threading.Tasks.Extensions - バージョン 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 Viewer のカルチャーサポート

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)