ビューア

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

以前の .NET Standard ライブラリは、メモリキャッシュ、HTTP コンテキストアクセッサ、そして 1 つ以上のライセンスパスを受け取る公開コンストラクタを提供していました。そのコンストラクタは廃止され、サービスグラフがこれらの依存関係を供給します。

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

OpenDocumentAsync（ドキュメントの非同期オープン）

ドキュメントを開き、クライアントウィジェットが以降のすべてのリクエストで使用するセッショントークンを返します。すべてのオープンは非同期で行われ、同期的な OpenDocument は存在しません。

// シンプルに開く
string token = await viewer.OpenDocumentAsync(path);

// フォーマットごとの設定とオプション付き
token = await viewer.OpenDocumentAsync(
    path,
    new PdfConfig { AllowSearch = true, AllowCopy = true },
    new DocOptions { TimeOut = 30 });

// アップロードから
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)

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

機能フラグ

これらを Razor ビューで使用して、サーバーが実際に提供する場合にのみ、ライセンスされたリボンを描画します — クイックスタート を参照してください。

DocOptions（ドキュメントオプション）

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

このクラスは、意図的に通常の単一ホスト閲覧フローの外にある専門的なプロパティも公開しています：

カスタム透かし

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出力はフレームごとにスタンプが付けられます。したがって、カスタム透かしはライセンスされたアプリケーション機能であり、評価透かしを置き換えたり抑制したりする手段ではありません。

アノテーション API

サーバー側のアノテーションの読み込みとエクスポート。完全なウォークスルーは Guides → Annotations にあります；概要は次のとおりです：

これらはすべてセッショントークンを受け取ります。以前のライブラリのセッションフリー
GetAnnotationManager(pageWidth, pageHeight) 形状は、セッション外でアノテーションを構築するために残っていますが、ロードするには依然としてトークンが必要です。

DICOM メタデータ

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

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

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

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

string ReferenceCss(CssConfig? config = null)      // null → Bootstrap + ビューア + 検索 + アノテーション
string ReferenceScripts(ScriptConfig? config = null)

CssConfig フラグ: IncludeBootstrapCss, IncludeViewerCss, IncludeSearchCss（検索制御）、IncludeAnnotationCss（注釈制御）。

ScriptConfig フラグ: IncludeJQuery（すべての他のものが必要とする）、IncludeBootstrap、IncludeViewerScripts（コア: docViewer.js + splitter + links）、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 }))

これらのヘルパーは、ブラウザリソースを配信するためにサポートされている方法です。アプリケーションが
docViewer.js、documentLinks.js、docViewer.UI.js を wwwroot にコピーした場合は
出力されたタグからページがレンダリングされるときに、それらのコピーを削除すべきです。