ビューア

Viewer (namespace Doconut) は、MVC コントローラ、Web Forms ページ、ハンドラからドキュメントを開くための公開エントリーポイントです。DoconutHost.Initialize によって構成される transient サービスです。使用する場所で解決してください:

var viewer = Doconut.DoconutHost.Services.GetRequiredService<Viewer>();

new Viewer() は DoconutHost.Initialize が実行された後でも動作します — 同じサービスを解決します — これにより、従来のパッケージから移行したコードのコンパイルが保たれます。Initialize の前に呼び出すと InvalidOperationException がスローされます。

Viewer はリクエストごとのドキュメント状態を保持せず、意図的に not IDisposable を実装していません：ドキュメントセッションはそれとは独立して存在するため、Viewer を破棄しても開いているドキュメントは閉じられません（ビューアの仕組み を参照）。

OpenDocumentAsync

ドキュメントを開き、ウィジェットが以降のすべてのリクエストで使用するセッショントークンを返します。UnsafeMode が false（デフォルト）の場合、トークンは現在のリクエストの ASP.NET セッションに付与されます — セッション状態を持つリクエストから呼び出してください（セッションとセキュリティ を参照）。

// 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 (HttpPostedFileBase in MVC; HttpPostedFile in Web Forms)
using (var ms = new MemoryStream())
{
    await file.InputStream.CopyToAsync(ms);
    ms.Position = 0;
    token = await viewer.OpenDocumentAsync(ms, new FileInfo(Path.GetFileName(file.FileName)));
}

対処すべき例外:

• LicenseException — ライセンスが見つかりましたが拒否されました（メッセージに理由が含まれます）、またはフォーマットがライセンスで許可されていないプラグイン機能を必要とする場合。
• FormatNotSupportedException — ファイルの拡張子を処理できるビューアがありません。
• InvalidDataException — コンテンツが破損しているか、拡張子と一致しません。

OpenDocument（同期）

Web Forms のコードビハインドや非同期ページを使用しないその他のコード向け:

string OpenDocument(string filePath, BaseConfig? config = null, DocOptions? options = null)
string OpenDocument(Stream stream, string fileName, BaseConfig? config = null, DocOptions? options = null)
string OpenDocument(byte[] bytes, string fileName, BaseConfig? config = null, DocOptions? options = null)

各メソッドはトークンを返し、さらに viewer.Token にも保存します。fileName は正しい拡張子を持つ必要があります。これらのラッパーは Web Forms ページから安全に呼び出せます：オープンパスは ASP.NET のリクエストコンテキストで再開されないため、待機してもデッドロックしません。すべての非同期 Doconut API が同様というわけではありません — コンバータプラグイン の Web Forms セクションを参照してください。

CloseDocument

void CloseDocument(string token)

セッションを削除し（ドキュメントエンジンを即座に解放）、現在のリクエストの ASP.NET セッションからトークンの権限を削除し、トークンを無効化します。オプションで、スライディング有効期限も同様のクリーンアップを行いますが、大きなドキュメントの場合は推奨されます。

Session queries

トークンが不明または期限切れの場合は例外がスローされます。

DocOptions

オープンごとの、フォーマットに依存しないオプション（名前空間 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つのフィールドがあることを期待します。無効な定義は、静かに消える代わりに目に見える Invalid Watermark テキストに置き換えられます。

License decision

同じ判断が配信ページとアノテーションエクスポートの両方に適用されます。カスタム透かしはライセンスされたアプリケーションの機能であり、評価用透かしを置き換える手段ではありません。

Annotations API

サーバー側のアノテーション読み込みとエクスポートです。概要は Annotations にあります。

DICOM メタデータ

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

このパッケージでは常に null を返し、ウィジェットのメタデータ要求は 501 Not Implemented で応答します。DICOM タグの読み取りは .NET Framework では利用できません。DICOM レンダリング（ページ、フレーム、アニメーション）は動作します。詳しくは DICOM プラグイン を参照してください。

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

リソースモジュールが DoconutOptions.ResourcesPath 配下で提供するリソースの <link> と <script> タグを依存順に出力します。ライセンスで制御される機能（検索、注釈）のファイルは、ライセンスがそれらを許可している場合にのみ出力されます。

string ReferenceCss(CssConfig? config = null)       // null → Bootstrap + viewer + search + annotation
string ReferenceScripts(ScriptConfig? config = null)
bool IsSearchEnabled { get; }                       // ライセンス状態、リボン初期化コードのガード用
bool IsAnnotationEnabled { get; }

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

ScriptConfig フラグ: IncludeJQuery（すべてのスクリプトが必要とする）、IncludeBootstrap, IncludeViewerScripts（コアビューアスクリプト）、IncludeSearchScripts と IncludeSearchBar（検索制御）、IncludeAnnotationScripts と IncludeAnnotationBar（注釈制御）。

どちらも HTML を返します。MVC 5 では @Html.Raw(...) で出力し（コントローラで生成し、ビューには @inject がない）、Web Forms では <%= %> を使用します。 クイックスタート に両方の例があります。

RenderViewer

string RenderViewer(string elementId, string token, ViewerConfig? config = null)

elementId を持つ要素上にウィジェットを初期化し、ドキュメントを表示する <script> ブロックを返します。ViewerConfig（デフォルト: BasePath: '/', ResPath: 'doconut-res/images'）から構築された docViewer({...}) を呼び出し、続いて .View(token) を実行します。ビューアスクリプトの後に記述してください。生成されたスクリプトはビューアオブジェクトへの参照を保持しないため、独自のツールバーを持つページではウィジェットを手動で初期化する必要があります。詳細は ViewerConfig を参照してください。

Web ファーム

string? AccessToken は、分散モードが有効で UnsafeMode が false の場合に、最新のオープンで発行された署名済みチケットを保持します。単一サーバー構成では null です。ウィジェットへトークンと共に送信します: objViewer.View(token, access)。