Der Basis‑Doconut‑Viewer für .NET 6 wird als ein NuGet‑Paket bereitgestellt, das in jede ASP.NET‑Core‑Anwendung eingebunden 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.NET6

Der Befehl ohne Versionsangabe installiert die neueste stabile Version. Um die aktuelle Version 26.7.0 exakt nachzubilden, übergeben Sie die Version als separate Option:

bash

dotnet add package Doconut.NET6 --version 26.7.0

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

Integration vor dem Upgrade identifizieren

Die Paket‑ID Doconut.NET6 wurde sowohl von der klassischen als auch von der aktuellen .NET 6‑Integration verwendet. Wählen Sie die Dokumentation nicht allein anhand des Paketnamens aus:

DocImage.axd, new Viewer(_cache, _accessor, ...), synchrones OpenDocument(...) und manuell kopierte Viewer‑Skripte kennzeichnen die klassische Integration;
AddDoconut(), UseDoconutResources(), ein injizierter Viewer und OpenDocumentAsync(...) kennzeichnen die hier dokumentierte aktuelle Integration.

Das übersetzte klassische Setup‑Handbuch ist weiterhin verfügbar. Verwenden Sie den Migrationsleitfaden, um Generationen zu wechseln; ein normales Paket‑Update konvertiert Startup, Viewer‑Lebensdauer oder Browser‑Ressourcen nicht automatisch.

Doconut registrieren

AddDoconut() ist der einzige Registrierungs‑Einstiegspunkt — es gibt nur eine Überladung, und sie 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 bewirkt, dass jede Anfrage an ein /doconut-res‑Asset nie den Ressourcen‑Handler erreicht und 404‑Fehler erzeugt. Die Session‑Verkabelung ist ebenfalls erforderlich — Doconut's Standard‑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 untenstehenden Vorgaben gelten, wenn eine Eigenschaft nicht gesetzt wird.

Eigenschaft	Standardwert	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 auf das tatsächliche `UseDoconut()`‑Mapping und den Client‑`BasePath`.
`ResourcesPath`	`"/doconut-res"`	Wo die eingebetteten JS/CSS/Bild‑Ressourcen bereitgestellt werden.
`LicensePath`	`""` (empty string)	Pfad zur Lizenzdatei. Ein leerer Wert bedeutet, zur nächsten Quelle weiterzuleiten, 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 6‑Dienste lesen die Lizenz während `AddDoconut()`; starten Sie die Anwendung neu, nachdem Sie eine 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 License Setup.

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.
Lizenz‑Einrichtung — wo Doconut nach Ihrer Lizenzdatei sucht.