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

Kommandot utan version installerar den senaste stabila versionen. För att exakt reproducera den aktuella 26.7.0‑utgåvan, 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 en slutlig middleware, så om den anropas först når varje begäran till en /doconut-res‑resurs aldrig resurshanteraren och ger 404. Sessionskopplingen krävs också — Doconuts standarddokumentssäkerhet validerar varje sidbegäran mot ASP.NET:s sessionstillstånd.

csharp

builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddSession(); // Doconut-dokumentsäkerhet bygger på ASP.NET-sessionstillstånd

app.UseSession();          // anropa UseSession() före UseDoconut()
app.UseDoconutResources(); // måste registreras före 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‑sessionens säkerhetskontroll över för sidbegäranden. Håll avstängd i produktion.
`MiddlewarePath`	`"/doconut"`	Koordinationsvärde för slutpunkten för sida‑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/bildresurserna levereras från.
`LicensePath`	`""` (empty string)	Sökväg till licensfilen. Tomt betyder att man går vidare 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 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 Licensinställning.

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

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