Den grundläggande Doconut‑visaren för .NET 6 levereras som ett NuGet‑paket som kan anslutas till vilken ASP.NET Core‑applikation som helst. Valfria tillägg använder separata paket. Denna sida installerar grundpaketet och registrerar middleware‑komponenterna — det minsta som behövs innan din första rendering.

Installera paketet

bash

dotnet add package Doconut.NET6

Kommandot utan version installerar den senaste stabila utgåvan. För att exakt reproducera den aktuella 26.7.0‑utgåvan, ange versionen som ett separat alternativ:

bash

dotnet add package Doconut.NET6 --version 26.7.0

Doconut.NET6 är paket‑ID:t. Suffixet .26.7.0 tillhör den nedladdade filen Doconut.NET6.26.7.0.nupkg och är inte en del av ID:t.

Identifiera integrationen innan uppgradering

Doconut.NET6‑paket‑ID har använts både av den klassiska och den nuvarande .NET 6‑integrationen. Välj inte dokumentation enbart baserat på paketnamnet:

DocImage.axd, new Viewer(_cache, _accessor, ...), synkron OpenDocument(...) och manuellt kopierade visarskript identifierar den klassiska integrationen;
AddDoconut(), UseDoconutResources(), en injicerad Viewer och OpenDocumentAsync(...) identifierar den nuvarande integrationen som dokumenteras här.

Den översatta klassiska installationsmanualen finns fortfarande tillgänglig. Använd migrationsguiden för att byta generation; en vanlig paketuppdatering konverterar inte start, visarlivstid eller webbläsarresurser automatiskt.

Registrera Doconut

AddDoconut() är den enda registreringspunkten — det finns en enda överlagring, och den kopplar Viewer‑tjänsten, licenstjänsten och renderingsinfrastrukturen till DI‑behållaren.

Två middleware‑anrop slutför konfigurationen, och deras ordning är viktig: UseDoconutResources() måste köras före UseDoconut(). UseDoconut() är terminal middleware, så om den anropas först nås aldrig resurshanteraren för en /doconut-res‑resurs och resulterar i 404. Sessionskopplingen krävs också — Doconut‑standarddokumentsäkerhet validerar varje sidförfrågan mot ASP.NET‑sessionsstatus.

csharp

builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddDistributedMemoryCache(); // sessionsstatus behöver en cache (MVC/Razor Pages lägger redan till en)
builder.Services.AddSession(); // Doconut-dokumentsäkerhet bygger på ASP.NET session state

app.UseSession();          // anropa UseSession() före UseDoconut()
app.UseDoconutResources(); // måste registreras före UseDoconut()
app.UseDoconut();

Alla alternativ

DoconutOptions accepterar följande inställningsbara egenskaper. Alla är valfria — standardvärdena nedan gäller när en egenskap lämnas odefinierad.

Egenskap	Standard	Beskrivning
`ShowDoconutInfo`	`false`	När `true` returnerar en begäran utan `token` en versionsbanner istället för en 404. Användbart som en snabbkontroll; håll avstängd i produktion.
`UnsafeMode`	`false`	När `true` hoppas ASP.NET‑sessionssäkerhetskontrollen över vid sidförfrågningar. Håll avstängd i produktion.
`MiddlewarePath`	`"/doconut"`	Koordinationsvärde för slutpunkten för sida‑bild. Det valideras, men skapar inte en gren i sig; håll det i linje med den faktiska `UseDoconut()`‑mappningen och klientens `BasePath`.
`ResourcesPath`	`"/doconut-res"`	Var de inbäddade JS/CSS/bild‑resurserna serveras från.
`LicensePath`	`""` (empty string)	Sökväg till licensfilen. Tomt betyder att man faller tillbaka till nästa källa, sedan autosökning.
`LicenseContent`	`""` (empty string)	Rå licensinnehåll — från en miljövariabel, en hemlighets‑hanterare eller en databas.
`LicenseStream`	`null`	Licens som en ström, läses en gång vid start.
`ResetLicense`	`false`	Reserverad kompatibilitetsflagga. De nuvarande .NET 6‑tjänsterna läser licensen under `AddDoconut()`; starta om appen efter att ha ersatt en licens.

Licensprioritet när mer än en källa är angiven: LicenseStream har företräde framför LicenseContent, som har företräde framför LicensePath, som har företräde framför autosökning — se Licensinställning.

csharp

builder.Services.AddDoconut(options =>
{
    options.LicensePath     = "Doconut.Viewer.lic";
    options.MiddlewarePath  = "/doconut";     // koordinera med app‑mappning och klientens BasePath
    options.ResourcesPath   = "/doconut-res"; // var visarens JS/CSS/bilder serveras från
    options.UnsafeMode      = false;          // behåll sessionssäkerhet på
    options.ShowDoconutInfo = false;
});

Nästa steg

Snabbstart — öppna ditt första dokument och rendera det i webbläsaren.
Licensinställning — var Doconut letar efter din licensfil.