Doconut の更新方法

.NET フレームワーク 4.7

Web.config 設定

ビューアは HttpHandler を web.config ファイルで登録する必要があります。IIS のバージョンに応じて、以下の web.config に定義されたセクションを使用して設定できます。

IIS 7 未満:

<httpHandlers>
  <add verb="GET,POST" path="DocImage.axd" type="Doconut.DocImageHandler, Doconut" />
</httpHandlers>

IIS 7 以上:

<handlers>
  <add name="DocImage" verb="GET,POST" path="DocImage.axd" type="Doconut.DocImageHandler, Doconut" />
</handlers>

ASPX ページでのレジスター更新

ASPX ページのアセンブリ登録を変更してください。

旧:

<%@ Register Assembly="DocumentViewer" Namespace="DotnetDaddy.DocumentViewer" TagPrefix="asp" %>

新:

<%@ Register Assembly="Doconut" Namespace="Doconut" TagPrefix="asp" %>

コントロールタグの更新

コントロールタグを DocViewer から Viewer に更新します。

旧:

<asp:DocViewer ID="ctlDoc" runat="server"/>

新:

<asp:Viewer ID="ctlDoc" runat="server"/>

名前空間の更新

Doconut 24.3.0 では名前空間が変更されました。新しい DLL を追加してください: Doconut.dll、Doconut.Formats.dll、Doconut.Configs.dll、Doconut.Clouds.dll。

新しい using:

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

初期化:

var viewer = new Viewer();

パッケージ依存関係

• Newtonsoft.Json 13.0.3（Newtonsoft.Json）
• System.Text.Encoding.CodePages 6.0.0（System.Text.Encoding.CodePages）
• System.Text.Json 6.0.0（System.Text.Json）

.NET スタンダード / コア

名前空間の更新

Doconut 24.3.0 では名前空間が変更されました。新しい DLL を追加してください: Doconut.dll、Doconut.Formats.dll、Doconut.Configs.dll、Doconut.Clouds.dll。

新しい using:

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

初期化:

using System;

// Viewer インスタンスは現在、ファクトリ、DI コンテナ、またはその他のプロバイダーから取得されます。
// GetViewer の実装を、実際の取得ロジックに置き換えてください。
Viewer GetViewer() => throw new NotImplementedException();

var viewer = GetViewer(); // Viewer インスタンスを取得する

パッケージ依存関係

• Microsoft.Extensions.Caching.Abstractions 3.1.10（Microsoft.Extensions.Caching.Abstractions）
• SkiaSharp 2.88.6（SkiaSharp）
• Newtonsoft.Json 13.0.3（Newtonsoft.Json）
• System.Drawing.Common 6.0.0（System.Drawing.Common）
• System.Text.Json 6.0.0（System.Text.Json）
• System.Text.Encoding.CodePages 7.0.0（System.Text.Encoding.CodePages）

.NET 6 以上

名前空間の更新

Doconut 24.3.0 では名前空間が変更されました。新しい DLL を追加してください: Doconut.dll、Doconut.Formats.dll、Doconut.Configs.dll、Doconut.Clouds.dll。

新しい using:

// 現在の .NET 6 統合: Viewer は DI から取得され、ドキュメントのオープンは非同期です。
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { AllowSearch = true });

初期化:

app.MapPost("/api/open", async (Viewer viewer) =>
{
    // トークンは不透明です — ウィジェットに渡し、決してログに記録したり永続化したりしないでください。
    string token = await viewer.OpenDocumentAsync("wwwroot/files/Sample.pdf");
    return Results.Ok(new { token });
});

パッケージ依存関係

• Microsoft.Extensions.Caching.Abstractions 3.1.10（Microsoft.Extensions.Caching.Abstractions）
• Newtonsoft.Json 13.0.3（Newtonsoft.Json）
• SkiaSharp 2.88.6（SkiaSharp）
• System.Drawing.Common 7.0.0（System.Drawing.Common）
• System.Text.Encoding.CodePages 7.0.0（System.Text.Encoding.CodePages）