Två migrationer 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.

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 ligger utanför detta, blockeras öppning — OpenDocumentAsync kastar LicenseException (fail-fast); den faller inte tillbaka till en 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 felen 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 är en omdesign kring DI och async. Mappningen:

Aspekt	.NET 6 / Standard 2.0	.NET 8
Inställning	Construct `Viewer(cache, httpContextAccessor, licensePath)`	`builder.Services.AddDoconut(options => …)` + injicera `Viewer`
Licens	Static `Viewer.DoconutLicense(path)` + `SetLicensePlugin(...)` per plugin	`options.LicensePath` / `LicenseContent` / `LicenseStream` — en licens, automatisk upptäckt för plugin‑filer
Öppna	`viewer.OpenDocument(...)` (synchronous)	`await viewer.OpenDocumentAsync(...)`
Stäng	`viewer.CloseDocument()` eller `viewer.Dispose()`	`viewer.CloseDocument(token)` — `Viewer` är inte `IDisposable`
Livstid	`Viewer` implementerar `IDisposable`, håller det öppna dokumentet	`Viewer` är stateless; sessioner lagras i cachen under tokens
Konverterare	`viewer.Converter`‑egenskapen	Converter‑pluginet (`AddPlugin<ConverterPlugin>()`) + `DocumentConverter`‑tjänsten
Konfigurationsklasser	`Doconut.Configs.View.*`‑namnutrymmen	Allt i `Doconut`‑namnutrymmet
Middleware	Manuell handler‑koppling	`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:

Kontrollen <doconut:DocViewer runat=server> försvinner — sidan hostar widget‑div‑paret och ditt endpoint returnerar token (Quick Start visar mönstret).
Statisk licensmetoder → DoconutOptions licenskällor.
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 runt ett oförändrat koncept: open → 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 migration

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 om säkerhetsvägen: AddSession()/UseSession() krävs nu med standard säkerhet.