Den grundläggande Doconut-visaren för .NET 8 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 — det minsta som behövs innan din första rendering.

Installera paketet

bash

dotnet add package Doconut.NET8

Det versionlösa kommandot installerar den senaste stabila versionen. För att exakt reproducera den aktuella 26.7.0-releasen, ange versionen som ett separat alternativ:

bash

dotnet add package Doconut.NET8 --version 26.7.0

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

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 kommer varje begäran till en /doconut-res-resurs aldrig nå resurshanteraren och resultera i 404. Sessionskopplingen krävs också — Doconut's standarddokumentsäkerhet validerar varje sidbegäran mot ASP.NET:s 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() innan UseDoconut()
app.UseDoconutResources(); // måste registreras innan UseDoconut()
app.UseDoconut();

Alla alternativ

DoconutOptions accepterar följande inställbara 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 sidbegäranden. Håll avstängd i produktion.
`MiddlewarePath`	`"/doconut"`	Koordinationsvärde för slutpunkten för sid‑bild. Det valideras, men monterar inte en gren av sig själv; håll det i linje med den faktiska `UseDoconut()`-mappningen och klientens `BasePath`.
`ResourcesPath`	`"/doconut-res"`	Var de inbäddade JS/CSS/bild‑resurserna levereras från.
`LicensePath`	`""` (tom sträng)	Sökväg till licensfilen. Tom betyder att den faller igenom till nästa källa, sedan autosökning.
`LicenseContent`	`""` (tom sträng)	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 uppstart.
`ResetLicense`	`false`	Reserverad kompatibilitetsflagga. De aktuella .NET 8‑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 License Setup.

csharp

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

Nästa steg

Quick Start — öppna ditt första dokument och rendera det i webbläsaren.
License Setup — där Doconut letar efter din licensfil.