Le visualiseur de base Doconut pour .NET 6 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.NET6

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

bash

dotnet add package Doconut.NET6 --version 26.7.0

Doconut.NET6 est l’identifiant du package. Le suffixe .26.7.0 appartient au nom de fichier téléchargé Doconut.NET6.26.7.0.nupkg et ne fait pas partie de l’identifiant.

Identifier l’intégration avant la mise à jour

L’identifiant de package Doconut.NET6 a été utilisé à la fois par l’intégration classique et l’intégration actuelle .NET 6. Ne choisissez pas la documentation uniquement sur la base du nom du package :

DocImage.axd, new Viewer(_cache, _accessor, ...), OpenDocument(...) synchrones, et les scripts du visualiseur copiés manuellement identifient l’intégration classique ;
AddDoconut(), UseDoconutResources(), un Viewer injecté, et OpenDocumentAsync(...) identifient l’intégration actuelle documentée ici.

Le manuel d’installation classique traduit reste disponible. Utilisez le guide de migration pour changer de génération ; une mise à jour normale du package ne convertit pas automatiquement le démarrage, la durée de vie du visualiseur ou les ressources du navigateur.

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 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é de document 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.AddDistributedMemoryCache(); // l'état de session nécessite un cache (MVC/Razor Pages en ajoutent déjà un)
builder.Services.AddSession(); // la sécurité de document 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 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`, ignore la vérification de sécurité de session ASP.NET sur les requêtes de pages. 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 6 actuels lisent la licence pendant `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"; // où 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.