Il visualizzatore base Doconut per .NET 6 viene distribuito come un unico pacchetto NuGet che si integra in qualsiasi applicazione ASP.NET Core. I plugin opzionali utilizzano pacchetti separati. Questa pagina installa il pacchetto base e registra il middleware — il minimo necessario prima del tuo primo rendering.

Installa il pacchetto

bash

dotnet add package Doconut.NET6

Il comando senza versione installa l'ultima release stabile. Per riprodurre esattamente la release 26.7.0 corrente, passa la versione come opzione separata:

bash

dotnet add package Doconut.NET6 --version 26.7.0

Doconut.NET6 è l'ID del pacchetto. Il suffisso .26.7.0 appartiene al nome file Doconut.NET6.26.7.0.nupkg scaricato e non fa parte dell'ID.

Identifica l'integrazione prima di aggiornare

L'ID del pacchetto Doconut.NET6 è stato usato sia per l'integrazione classica sia per quella corrente di .NET 6. Non selezionare la documentazione solo dal nome del pacchetto:

DocImage.axd, new Viewer(_cache, _accessor, ...), OpenDocument(...) sincrono, e script del visualizzatore copiati manualmente identificano l'integrazione classica;
AddDoconut(), UseDoconutResources(), un Viewer iniettato, e OpenDocumentAsync(...) identificano l'integrazione corrente documentata qui.

Il manuale di configurazione classica tradotto rimane disponibile. Usa la guida alla migrazione per cambiare generazione; un normale aggiornamento del pacchetto non converte automaticamente l'avvio, la durata del visualizzatore o le risorse del browser.

Registra Doconut

AddDoconut() è l'unico punto di ingresso per la registrazione — esiste un unico overload, e collega il servizio Viewer, il servizio licenza e l'infrastruttura di rendering al contenitore DI.

Due chiamate al middleware completano la configurazione, e il loro ordine è importante: UseDoconutResources() deve essere eseguito prima di UseDoconut(). UseDoconut() è middleware terminale, quindi chiamarlo per primo significa che ogni richiesta a una risorsa /doconut-res non raggiunge il gestore delle risorse e restituisce 404. È inoltre necessario il wiring della sessione — la sicurezza dei documenti Doconut valida ogni richiesta di pagina contro lo stato di sessione ASP.NET.

csharp

builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddDistributedMemoryCache(); // lo stato di sessione richiede una cache (MVC/Razor Pages ne aggiungono già una)
builder.Services.AddSession(); // la sicurezza dei documenti Doconut si basa sullo stato di sessione ASP.NET

app.UseSession();          // chiama UseSession() prima di UseDoconut()
app.UseDoconutResources(); // deve essere registrato prima di UseDoconut()
app.UseDoconut();

Tutte le opzioni

DoconutOptions accetta le seguenti proprietà impostabili. Ognuna è opzionale — i valori predefiniti qui sotto si applicano quando una proprietà rimane non impostata.

Proprietà	Predefinito	Descrizione
`ShowDoconutInfo`	`false`	Quando `true`, una richiesta senza `token` restituisce un banner di versione invece di un 404. Utile per un controllo rapido; disattivare in produzione.
`UnsafeMode`	`false`	Quando `true`, salta il controllo di sicurezza basato sulla sessione ASP.NET nelle richieste di pagina. Disattivare in produzione.
`MiddlewarePath`	`"/doconut"`	Valore di coordinamento per l'endpoint pagina-immagine. Viene validato, ma non monta un ramo da solo; mantienilo allineato con il mapping effettivo di `UseDoconut()` e il `BasePath` del client.
`ResourcesPath`	`"/doconut-res"`	Dove vengono servite le risorse JS/CSS/immagine incorporate.
`LicensePath`	`""` (stringa vuota)	Percorso al file di licenza. Vuoto significa passare alla fonte successiva, poi ricerca automatica.
`LicenseContent`	`""` (stringa vuota)	Contenuto della licenza grezzo — da una variabile d'ambiente, un gestore di segreti o un database.
`LicenseStream`	`null`	Licenza come stream, letta una volta all'avvio.
`ResetLicense`	`false`	Flag di compatibilità riservato. I servizi .NET 6 attuali leggono la licenza durante `AddDoconut()`; riavvia l'app dopo aver sostituito una licenza.

Priorità della licenza quando più di una fonte è impostata: LicenseStream prevale su LicenseContent, che prevale su LicensePath, che prevale sulla ricerca automatica — vedi Impostazione Licenza.

csharp

builder.Services.AddDoconut(options =>
{
    options.LicensePath     = "Doconut.Viewer.lic";
    options.MiddlewarePath  = "/doconut";     // coordinare con il mapping dell'app e il BasePath del client
    options.ResourcesPath   = "/doconut-res"; // da dove vengono serviti i JS/CSS/immagini del visualizzatore
    options.UnsafeMode      = false;          // mantenere la sicurezza della sessione attiva
    options.ShowDoconutInfo = false;
});

Prossimi passi

Quick Start — apri il tuo primo documento e visualizzalo nel browser.
License Setup — dove Doconut cerca il tuo file di licenza.