Le visualiseur de base Doconut pour .NET 8 est fourni sous forme d'un seul package NuGet qui s'intègre à n'importe quelle 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 unique, et il connecte le service Viewer, le service de licence et l'infrastructure de rendu dans le conteneur d'injection de dépendances.

Deux appels de middleware complètent la configuration, et leur ordre est important : UseDoconutResources() doit être exécuté 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 branchement de la session est également requis — la sécurité documentaire par défaut de 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.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();

Toutes les options

DoconutOptions accepte les propriétés configurables 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`, contourne la vérification de sécurité de la 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 par elle‑même ; 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. Une chaîne 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, lue 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 licence.

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

Étapes suivantes

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