Il visualizzatore base Doconut per .NET 6 viene fornito 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 corrente 26.7.0, 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 scaricato Doconut.NET6.26.7.0.nupkg e non fa parte dell'ID.

Identifica l'integrazione prima dell'aggiornamento

L'ID del pacchetto Doconut.NET6 è stato usato sia per l'integrazione classica sia per quella corrente di .NET 6. Non selezionare la documentazione basandoti solo sul 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 classico tradotto è ancora 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 fa sì che ogni richiesta a una risorsa /doconut-res non raggiunga il gestore delle risorse e restituisca 404. È inoltre necessario il collegamento della sessione — la sicurezza documentale predefinita di Doconut valida ogni richiesta di pagina contro lo stato della sessione ASP.NET.

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

Tutte le opzioni

DoconutOptions accetta le seguenti proprietà configurabili. Ognuna è opzionale — i valori predefiniti 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 della sessione ASP.NET sulle 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 la mappatura reale di `UseDoconut()` e con il `BasePath` del client.
`ResourcesPath`	`"/doconut-res"`	Dove vengono servite le risorse incorporate JS/CSS/immagine.
`LicensePath`	`""` (stringa vuota)	Percorso al file di licenza. Vuoto significa passare alla fonte successiva, quindi ricerca automatica.
`LicenseContent`	`""` (stringa vuota)	Contenuto grezzo della licenza — 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 è impostata più di una fonte: LicenseStream prevale su LicenseContent, che prevale su LicensePath, che prevale sulla ricerca automatica — vedi Configurazione licenza.

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

Passi successivi

Avvio rapido — apri il tuo primo documento e visualizzalo nel browser.
Configurazione licenza — dove Doconut cerca il tuo file di licenza.