Der Basis‑Doconut‑Viewer für .NET 8 wird als ein NuGet‑Paket geliefert, das in jede ASP.NET‑Core‑Anwendung integriert werden kann. Optionale Plugins verwenden separate Pakete. Diese Seite installiert das Basis‑Paket und registriert die Middleware — das Minimum, das vor Ihrer ersten Darstellung erforderlich ist.

Paket installieren

bash

dotnet add package Doconut.NET8

Der unveröffentlichte Befehl installiert die neueste stabile Version. Um die aktuelle 26.7.0 Release exakt nachzubilden, übergeben Sie die Version als separate Option:

bash

dotnet add package Doconut.NET8 --version 26.7.0

Doconut.NET8 ist die Paket‑ID. Der Suffix .26.7.0 gehört zum heruntergeladenen Doconut.NET8.26.7.0.nupkg‑Dateinamen und ist nicht Teil der ID.

Doconut registrieren

AddDoconut() ist der einzige Registrierungseintrittspunkt — es gibt nur eine Überladung, und es verbindet den Viewer‑Dienst, den Lizenz‑Dienst und die Rendering‑Infrastruktur mit dem DI‑Container.

Zwei Middleware‑Aufrufe vervollständigen die Einrichtung, und ihre Reihenfolge ist wichtig: UseDoconutResources() muss vor UseDoconut() ausgeführt werden. UseDoconut() ist terminale Middleware, sodass ein Aufruf zuerst bedeutet, dass jede Anfrage an ein /doconut-res‑Asset nie den Ressourcen‑Handler erreicht und mit 404 beantwortet wird. Das Session‑Wiring ist ebenfalls erforderlich — Doconuts standardmäßige Dokumentensicherheit prüft jede Seitenanfrage gegen den ASP.NET‑Session‑State.

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();

Alle Optionen

DoconutOptions akzeptiert die folgenden einstellbaren Eigenschaften. Jede ist optional — die unten angegebenen Standardwerte gelten, wenn eine Eigenschaft nicht gesetzt wird.

Eigenschaft	Standard	Beschreibung
`ShowDoconutInfo`	`false`	Wenn `true`, gibt eine Anfrage ohne `token` ein Versionsbanner statt eines 404 zurück. Nützlich als Schnelltest; in der Produktion deaktivieren.
`UnsafeMode`	`false`	Wenn `true`, wird die ASP.NET‑Session‑Sicherheitsprüfung bei Seitenanfragen übersprungen. In der Produktion deaktivieren.
`MiddlewarePath`	`"/doconut"`	Koordinationswert für den Seiten‑Bild‑Endpunkt. Er wird validiert, mountet jedoch keinen eigenen Zweig; halten Sie ihn abgestimmt mit dem tatsächlichen `UseDoconut()`‑Mapping und dem Client‑`BasePath`.
`ResourcesPath`	`"/doconut-res"`	Von wo aus die eingebetteten JS/CSS/Image‑Ressourcen bereitgestellt werden.
`LicensePath`	`""` (empty string)	Pfad zur Lizenzdatei. Ein leerer Wert bedeutet, dass zur nächsten Quelle weitergegangen wird, dann automatische Suche.
`LicenseContent`	`""` (empty string)	Roh‑Lizenzinhalt — aus einer Umgebungsvariablen, einem Secret‑Manager oder einer Datenbank.
`LicenseStream`	`null`	Lizenz als Stream, einmal beim Start gelesen.
`ResetLicense`	`false`	Reserviertes Kompatibilitäts‑Flag. Die aktuellen .NET 8‑Dienste lesen die Lizenz während `AddDoconut()`; starten Sie die Anwendung neu, nachdem Sie die Lizenz ausgetauscht haben.

Lizenz‑Priorität, wenn mehr als eine Quelle gesetzt ist: LicenseStream schlägt LicenseContent, das LicensePath schlägt die automatische Suche — siehe Lizenzsetup.

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ächste Schritte

Schnellstart — öffnen Sie Ihr erstes Dokument und rendern Sie es im Browser.
Lizenzsetup — wo Doconut nach Ihrer Lizenzdatei sucht.