Il visualizzatore base Doconut per .NET 8 è 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.NET8

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

bash

dotnet add package Doconut.NET8 --version 26.7.0

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

Registra Doconut

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

Due chiamate middleware completano la configurazione, e il loro ordine è importante: UseDoconutResources() deve essere eseguito prima di UseDoconut(). UseDoconut() è un 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. Il collegamento della sessione è necessario anche — 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(); // La sicurezza dei documenti Doconut si basa sulla 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à configurabili. Ognuna è opzionale — i valori predefiniti qui sotto si applicano quando una proprietà non è impostata.

Proprietà	Predefinito	Descrizione
`ShowDoconutInfo`	`false`	Quando `true`, una richiesta senza `token` restituisce un banner di versione invece di un 404. Utile come verifica rapida; disabilitarlo in produzione.
`UnsafeMode`	`false`	Quando `true`, salta il controllo di sicurezza della sessione ASP.NET sulle richieste di pagina. Disabilitarlo 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 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 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à riservata. I servizi .NET 8 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 License Setup.

csharp

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

Prossimi passi

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