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 — 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 versionen. För att exakt reproducera den aktuella 26.7.0-releasen, 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 filnamnet 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‑integrationerna. 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 generationer; en vanlig paketuppdatering konverterar inte start, visarlivstid eller webbläsarresurser automatiskt.

Registrera Doconut

AddDoconut() är den enda registreringsingångspunkten — 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år ingen förfrågan till en /doconut-res‑resurs resurs‑hanteraren och får 404. Sessionskopplingen krävs också — Doconut's standarddokument‑säkerhet validerar varje sidförfrågan mot ASP.NET‑sessionsstate.

csharp

builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddSession(); // Doconut document security rides on ASP.NET session state

app.UseSession();          // call UseSession() before UseDoconut()
app.UseDoconutResources(); // must be registered before 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 förfrågan utan `token` en versionsbanner istället för en 404. Användbar 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 sid‑bild‑endpointen. Det valideras, men monterar inte en gren i sig självt; 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 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";     // coordinate with app mapping and client BasePath
    options.ResourcesPath   = "/doconut-res"; // where the viewer's JS/CSS/images are served from
    options.UnsafeMode      = false;          // keep session security on
    options.ShowDoconutInfo = false;
});

Nästa steg

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