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 actuelle 26.7.0, indiquez la version comme option séparée :

bash

dotnet add package Doconut.NET6 --version 26.7.0

Doconut.NET6 est l'ID 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'ID.

Identifier l'intégration avant la mise à jour

L'ID du 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, 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 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.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 réglables suivantes. Chacune est facultative — 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 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, lu une fois au démarrage.
`ResetLicense`	`false`	Drapeau de compatibilité réservé. Les services .NET 6 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";     // 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 la licence — où Doconut recherche votre fichier de licence.