ビューア

Viewer (namespace Doconut) は、Razor ページ、MVC コントローラー、Blazor コンポーネント、または最小限の API からドキュメントを開くための公開エントリーポイントです。sealed であり、AddDoconut() によって transient サービスとして登録され、コンストラクタ インジェクションで解決されます — 直接インスタンス化しないでください。

Viewer はリクエストごとの状態を保持せず、意図的に IDisposable を実装 しません：ドキュメント セッションはセッション キャッシュ内で独立して存続するため、サービスを破棄しても開かれたドキュメントを終了させることはできません（Core Concepts → ビューアの仕組み を参照）。

OpenDocumentAsync（ドキュメントを開く）

ドキュメントを開き、クライアント ウィジェットが以降のすべてのリクエストで使用するセッショントークンを返します。

// Simple open
string token = await viewer.OpenDocumentAsync(path);

// With per-format config and options
token = await viewer.OpenDocumentAsync(
    path,
    new PdfConfig { AllowSearch = true, AllowCopy = true },
    new DocOptions { TimeOut = 30 });

// From an upload
await using var ms = new MemoryStream();
await file.CopyToAsync(ms);
ms.Position = 0;
token = await viewer.OpenDocumentAsync(ms, new FileInfo(file.FileName));

対処すべき例外:

• LicenseException — 見つかったライセンスが拒否される（メッセージに拒否理由が含まれる）か、フォーマットがもはや許可されていないプラグイン機能を必要とする。拒否メッセージなしの期限切れカレンダーは、例外を投げる代わりに透かし付きレンダリングにフォールバックします。
• FormatNotSupportedException — Document format '<extension>' is not supported.
• InvalidDataException — ファイル内容が破損しているか、拡張子と一致しません。

CloseDocument（セッションを閉じる）

void CloseDocument(string token)

キャッシュからセッションを削除し（ドキュメント エンジンを即座に破棄）、セキュリティ マーカーを削除し、アクセス権を取り消します。オプションとしてスライディング有効期限でも同様のクリーンアップが行われますが、大きなドキュメントの場合は推奨されます。

GetPageCount（ページ数取得）

int GetPageCount(string token)

開かれたセッションの総ページ数を返します。トークンが不明または期限切れの場合は例外がスローされます。

DocOptions（オプション設定）

オープンごとの、フォーマットに依存しないオプション（namespace Doconut）：

クラスは通常のシングルホスト表示フローの外に意図的に配置された、以下のような特殊プロパティも公開しています：

Custom watermark（カスタム透かし）

DocOptions.Watermark は 6 つのチルダ区切りフィールドを使用します。オプションの先頭 ^ は全コーナーレイアウトを要求します：

^Text~Color~FontSize~FontName~Opacity~Angle

string token = await viewer.OpenDocumentAsync(
    path,
    new PdfConfig(),
    new DocOptions
    {
        Watermark = "^Confidential~Red~24~Verdana~80~-45",
        TimeOut = 30
    });

パーサはオプションの ^ の後に正確に 6 つのフィールドがあることを期待します。無効な定義は SDK の可視 Invalid Watermark フォールバックに置き換えられ、黙って消えることはありません。

ライセンス判定

同じ判断が配信されたページ画像およびアノテーション エクスポートにも適用されます。アニメーション GIF 出力はフレームごとに透かしがスタンプされます。したがってカスタム透かしは評価透かしを置き換えたり抑制したりする手段ではなく、ライセンスされた機能です。

アノテーション（サーバー側ロードとエクスポート）

サーバー側のアノテーションのロードとエクスポート。完全な手順は Guides → アノテーション にあります。インターフェースは次のとおりです：

DICOM metadata（DICOM メタデータ）

Task<DicomMetadata?> GetDicomMetadataAsync(string token, CancellationToken ct = default)

このメソッドは API 整合性のために存在しますが、.NET 6 DICOM ビューアは技術タグを提供できません。DICOM セッションでも非 DICOM セッションでも null を返し、DICOM セッションの場合はプラットフォーム制限を説明する一度だけの警告が出力されます。ページ、フレーム、アニメーションのレンダリングは引き続きサポートされています。

リソースヘルパー — ReferenceCss / ReferenceScripts（リソースヘルパー）

UseDoconutResources() が提供する埋め込みリソース用の <link> / <script> タグを正しい依存順序で出力します。検索やアノテーションなどライセンスで制御される機能のバンドルは、ライセンスが有効な場合にのみ出力され、クライアント UI とサーバー側の動作が一致します。

string ReferenceCss(CssConfig? config = null)      // null → Bootstrap + viewer + search + annotation
string ReferenceScripts(ScriptConfig? config = null)

CssConfig フラグ: IncludeBootstrapCss（Bootstrap を含める）、IncludeViewerCss（ビューアの CSS を含める）、IncludeSearchCss（検索機能が有効な場合に含める）、IncludeAnnotationCss（アノテーション機能が有効な場合に含める）。

ScriptConfig フラグ: IncludeJQuery（すべてのスクリプトが依存する必須項目）、IncludeBootstrap（Bootstrap を含める）、IncludeViewerScripts（コア: docViewer.js + スプリッタ + リンク）、IncludeSearchScripts と IncludeSearchBar（検索機能が有効な場合に含める）、IncludeAnnotationScripts と IncludeAnnotationBar（アノテーション機能が有効な場合に含める）。

@inject Doconut.Viewer Viewer

@Html.Raw(Viewer.ReferenceCss(new CssConfig { IncludeBootstrapCss = true, IncludeViewerCss = true }))
@Html.Raw(Viewer.ReferenceScripts(new ScriptConfig { IncludeJQuery = true, IncludeViewerScripts = true }))