Två migreringar finns på den här sidan: uppgradering av paketversionen inom .NET 8, och flytt av en integration från ett äldre Doconut-ramverk (.NET 6, .NET Standard 2.0, .NET Framework 4.7) till .NET 8 API:et.

Uppgradering av paketversionen

Uppdatera paketet (och eventuella pluginpaket — håll versionerna i linje):

bash

dotnet add package Doconut.NET8
dotnet add package Doconut.NET8.Dicom

Kontrollera licensfönstret. En licens täcker ett versionsintervall. Om den nya versionen faller utanför det, blockeras öppning — OpenDocumentAsync kastar LicenseException (fail-fast); den återgår inte till ett vattenstämpel, och IsVersionValid blir false. Förnya, ersätt .lic-filen och starta om applikationen så att AddDoconut() laddar den nya licensen.
Bygg om och låt NuGet återställa de deklarerade beroendeversionerna — återfäst inte System.Text.Json eller System.Drawing.Common (se Felsökning för de exakta fel som en nedgradering orsakar).
Gör ett röktest med ett dokument per formatfamilj du använder.

Migrering från .NET 6 / .NET Standard 2.0

.NET 8 API:et är en omdesign kring DI och asynkronitet. Mappningen:

Aspekt	.NET 6 / Standard 2.0	.NET 8
Setup	Konstruktör `Viewer(cache, httpContextAccessor, licensePath)`	`builder.Services.AddDoconut(options => …)` + injicera `Viewer`
License	Statisk `Viewer.DoconutLicense(path)` + `SetLicensePlugin(...)` per plugin	`options.LicensePath` / `LicenseContent` / `LicenseStream` — en licens, automatisk upptäckt av plugin‑filer
Open	`viewer.OpenDocument(...)` (synkron)	`await viewer.OpenDocumentAsync(...)`
Close	`viewer.CloseDocument()` eller `viewer.Dispose()`	`viewer.CloseDocument(token)` — `Viewer` är inte `IDisposable`
Lifetime	`Viewer` implementerar `IDisposable`, håller det öppna dokumentet	`Viewer` är stateless; sessioner lagras i cachen under token
Converter	`viewer.Converter`-egenskap	Converter‑plugin (`AddPlugin<ConverterPlugin>()`) + `DocumentConverter`‑tjänsten
Config classes	`Doconut.Configs.View.*`-namnrymder	Alla i `Doconut`‑namnrymden
Middleware	Manuell hanteringskoppling	`app.UseDoconutResources()` + `app.UseDoconut()`

Ett typiskt före/efter:

text

// .NET 6 (old API, shown for contrast — not valid on .NET 8)
using var viewer = new Viewer(cache, httpContextAccessor, "wwwroot/Doconut.Viewer.lic");
var token = viewer.OpenDocument(path, new PdfConfig { AllowSearch = true }, new DocOptions());

csharp

// .NET 8 — Viewer injected, license configured once in AddDoconut()
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { AllowSearch = true });

Migrering från .NET Framework 4.7 (Web Forms)

4.7 Viewer är en WebControl; .NET 8 ersätter kontrollmodellen med middleware + en DI‑tjänst:

<doconut:DocViewer runat=server>-kontrollen försvinner — sidan är värd för widget-div-paret och ditt endpoint returnerar token (Quick Start visar mönstret).
Statisk licensmetoder → licenskällor i DoconutOptions.
Synkron OpenDocument → await OpenDocumentAsync.
Viewer.ReferenceScripts() / ReferenceCss() finns i båda världarna — .NET 8‑versionerna tar ScriptConfig/CssConfig‑objekt och är licensstyrda.
Kontrollegenskaper (ShowThumbs, PageZoom, FixedZoom, …) → samma namn på ViewerConfig / docViewer‑JS‑alternativen.
Exportmetoder som returnerar byte[] → de asynkrona annoterings‑export‑API:erna på Viewer.

Planera detta som en omskrivning av värdslagret kring ett oförändrat koncept: öppna → token → widget.

Namnnotering

I alla ramverk är klassen Viewer — om du hittar DocumentViewer i gamla kodsnuttar eller tredjepartsartiklar, har den typen aldrig funnits i SDK:n.

Checklista för migrering

Byt paket; justera pluginpaketens versioner.
Flytta licensinställningarna till AddDoconut(); ta bort statiska licensanrop.
Gör öppningsanrop asynkrona; ersätt Dispose/parameterlös CloseDocument med CloseDocument(token).
Ersätt viewer.Converter‑användningar med registrering av Converter‑plugin + DocumentConverter.
Testa säkerhetsvägen igen: AddSession()/UseSession() krävs nu med standard säkerhet.