Le visualiseur de base Doconut pour .NET 8 est fourni sous forme d'un seul package NuGet qui s'intègre à toute application ASP.NET Core. Les plugins optionnels utilisent des packages séparés. Cette page installe le package de base et enregistre le middleware — le minimum nécessaire avant votre premier rendu.

Installer le package

bash

dotnet add package Doconut.NET8

La commande sans version installe la dernière version stable. Pour reproduire exactement la version actuelle 26.7.0, indiquez la version comme option séparée :

bash

dotnet add package Doconut.NET8 --version 26.7.0

Doconut.NET8 est l'ID du package. Le suffixe .26.7.0 appartient au nom de fichier téléchargé Doconut.NET8.26.7.0.nupkg et ne fait pas partie de l'ID.

Enregistrer Doconut

AddDoconut() est le seul point d'entrée d'enregistrement — il n'existe qu'une surcharge, et il connecte le service Viewer, le service de licence et l'infrastructure de rendu dans le conteneur DI.

Deux appels middleware complètent la configuration, et leur ordre est important : UseDoconutResources() doit s'exécuter avant UseDoconut(). UseDoconut() est un middleware terminal, donc le placer en premier signifie que chaque requête vers une ressource /doconut-res n'atteint jamais le gestionnaire de ressources et renvoie un 404. Le câblage de la session est également requis — la sécurité documentaire Doconut valide chaque requête de page contre l'état de session ASP.NET.

csharp

builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddDistributedMemoryCache(); // l'état de session nécessite un cache (MVC/Razor Pages en ajoute déjà un)
builder.Services.AddSession(); // la sécurité documentaire Doconut repose sur l'état de session ASP.NET

app.UseSession();          // appel de UseSession() avant UseDoconut()
app.UseDoconutResources(); // doit être enregistré avant UseDoconut()
app.UseDoconut();

Toutes les options

DoconutOptions accepte les propriétés réglables suivantes. Chacune est optionnelle — les valeurs par défaut ci‑dessous s'appliquent lorsqu'une propriété n'est pas définie.

Propriété	Valeur par défaut	Description
`ShowDoconutInfo`	`false`	Lorsque `true`, une requête sans `token` renvoie une bannière de version au lieu d'un 404. Utile comme vérification rapide ; désactiver en production.
`UnsafeMode`	`false`	Lorsque `true`, ignore la vérification de sécurité de session ASP.NET sur les requêtes de page. Désactiver en production.
`MiddlewarePath`	`"/doconut"`	Valeur de coordination pour le point de terminaison page-image. Elle est validée, mais ne monte pas de branche à elle seule ; maintenez-la alignée avec le mappage réel de `UseDoconut()` et le `BasePath` du client.
`ResourcesPath`	`"/doconut-res"`	Emplacement depuis lequel les ressources JS/CSS/image intégrées sont servies.
`LicensePath`	`""` (empty string)	Chemin vers le fichier de licence. Vide signifie passer à la source suivante, puis recherche automatique.
`LicenseContent`	`""` (empty string)	Contenu brut de la licence — provenant d'une variable d'environnement, d'un gestionnaire de secrets ou d'une base de données.
`LicenseStream`	`null`	Licence sous forme de flux, lu une fois au démarrage.
`ResetLicense`	`false`	Drapeau de compatibilité réservé. Les services .NET 8 actuels lisent la licence lors de `AddDoconut()` ; redémarrez l'application après avoir remplacé une licence.

Priorité des licences lorsqu'il y a plusieurs sources définies : LicenseStream l'emporte sur LicenseContent, qui l'emporte sur LicensePath, qui l'emporte sur la recherche automatique — voir Configuration de la licence.

csharp

builder.Services.AddDoconut(options =>
{
    options.LicensePath     = "Doconut.Viewer.lic";
    options.MiddlewarePath  = "/doconut";     // coordonner avec le mappage de l'application et le BasePath du client
    options.ResourcesPath   = "/doconut-res"; // emplacement depuis lequel les JS/CSS/images du visualiseur sont servis
    options.UnsafeMode      = false;          // maintenir la sécurité de session activée
    options.ShowDoconutInfo = false;
});

Étapes suivantes

Démarrage rapide — ouvrez votre premier document et affichez‑le dans le navigateur.
Configuration de la licence — où Doconut recherche votre fichier de licence.