Der Basis‑Doconut‑Viewer für .NET 6 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.NET6

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

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 für die klassische als auch für die aktuelle .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 aktuelle, hier dokumentierte Integration.

Das übersetzte klassische Installationshandbuch 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 — 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.AddDistributedMemoryCache(); // Session‑State benötigt einen Cache (MVC/Razor Pages fügen bereits einen hinzu)
builder.Services.AddSession(); // Doconut‑Dokumentensicherheit nutzt den ASP.NET‑Session‑State

app.UseSession();          // Aufruf von UseSession() vor UseDoconut()
app.UseDoconutResources(); // muss vor UseDoconut() registriert werden
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`, liefert eine Anfrage ohne `token` ein Versionsbanner anstelle eines 404. 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/Image‑Ressourcen bereitgestellt werden.
`LicensePath`	`""` (empty string)	Pfad zur Lizenzdatei. Ein leerer Wert bedeutet, zur nächsten Quelle weiterzuleiten, anschließend automatische Suche.
`LicenseContent`	`""` (empty string)	Roh‑Lizenzinhalt — aus einer Umgebungsvariable, 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 Lizenz‑Einrichtung.

csharp

builder.Services.AddDoconut(options =>
{
    options.LicensePath     = "Doconut.Viewer.lic";
    options.MiddlewarePath  = "/doconut";     // Koordination mit App‑Mapping und Client‑BasePath
    options.ResourcesPath   = "/doconut-res"; // wo die JS/CSS/Images des Viewers bereitgestellt werden
    options.UnsafeMode      = false;          // Session‑Sicherheit aktiv lassen
    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.