Installation
Ajoutez Doconut à votre projet .NET Standard 2.1
Le visualiseur de base Doconut pour .NET Standard 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, confirme que votre hôte peut le consommer et enregistre le middleware — le minimum nécessaire avant votre premier rendu.
Vérifiez d'abord le framework de l'hôte
La bibliothèque cible netstandard2.1. C'est un contrat plus restrictif que la version précédente netstandard2.0, et c'est la première chose à vérifier :
| Hôte | Pris en charge |
|---|---|
| .NET Core 3.0 ou ultérieur, incluant .NET 5/6/7/8 | Oui |
| .NET Framework (toute version) | Non — netstandard2.1 ne peut pas être utilisé par .NET Framework |
Le package fonctionne uniquement sur Windows. Pour un hôte Linux, utilisez Doconut.NET8 ou Doconut.NET6.
Si l'application s'exécute sur .NET Framework, ce n'est pas le bon package. Utilisez Doconut.NETFramework à la place ; à partir de la version 26.9.0, il nécessite .NET Framework 4.7.2.
Installer le package
dotnet add package Doconut.NETStandardLa commande sans version installe la dernière version stable. Pour fixer la version décrite dans cette documentation, passez la version comme option séparée :
dotnet add package Doconut.NETStandard --version 26.10.0Doconut.NETStandard est l'ID du package. Le suffixe de version appartient au nom de fichier Doconut.NETStandard.<version>.nupkg téléchargé et ne fait pas partie de l'ID.
Le numéro de version correspond à la génération
Cela importe davantage ici que le nom du package. Les deux générations de la bibliothèque .NET Standard sont publiées sous le même ID de package, et seule la version les différencie :
| Version | Cible | API |
|---|---|---|
| 26.7.0 et antérieures | netstandard2.0 | l'intégration précédente |
| 26.8.0 et supérieures | netstandard2.1 | l'intégration documentée ici |
Il n'existe aucun shim de compatibilité et aucun package côte à côte. Mettre à jour la version est la mise à niveau, et le compilateur signalera immédiatement les différences d'API.
Ne choisissez pas la documentation uniquement à partir du nom du package :
new Viewer(_cache, _accessor, …),UnSafeMode,OpenDocument(...)synchrones,viewer.InitCache(),UseDoconutWebFarm, et les scripts de visualiseur copiés manuellement identifient l'intégration précédente ;AddDoconut(),UseDoconutResources(), unViewerinjecté, etOpenDocumentAsync(...)identifient l'intégration actuelle documentée ici.
Le manuel d'installation précédent traduit reste disponible. Utilisez le guide de migration pour changer de génération ; une mise à jour 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 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 l'appeler en premier signifie que chaque requête vers une ressource /doconut-res n'atteint jamais le gestionnaire de ressources et renvoie un 404. UseDoconut() répond à chaque requête qui l'atteint, donc montez-le sur sa propre branche avec app.Map. Le câblage de 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.
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é des documents Doconut repose sur l'état de session ASP.NET
app.UseSession(); // appelez UseSession() avant UseDoconut()
app.UseDoconutResources(); // doit être enregistré avant UseDoconut()
app.Map("/doconut", branch => branch.UseDoconut());Espaces de noms
Les types de configuration ne sont plus répartis sur quatre espaces de noms. Dans cette version, presque tout se trouve dans l'espace de noms racine Doconut :
using Doconut; // Viewer, DoconutOptions, DocOptions, toutes les configurations de format
using Doconut.Middleware; // AddDoconut, UseDoconut, UseDoconutResources
using Doconut.Clouds; // configurations cloud et partage de fichiers
using Doconut.Configs.Conversion; // ConversionTargetLes noms de types eux-mêmes n'ont pas changé — PdfConfig, WordConfig, ExcelConfig, CssConfig, ScriptConfig et le reste sont toujours présents. Si vous migrez une application existante, la plupart des fichiers n'ont besoin que de deux lignes using supprimées ; consultez le guide de migration.
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 test de validation ; désactivez en production. |
UnsafeMode | false | Lorsque true, la vérification de sécurité de session ASP.NET sur les requêtes de pages est ignorée. Désactivez en production. Notez l'orthographe — la bibliothèque précédente appelait cela UnSafeMode. |
MiddlewarePath | "/doconut" | Valeur de coordination pour le point de terminaison page-image. Elle est validée, mais ne crée pas de branche par elle‑même ; maintenez‑la alignée avec le mappage réel UseDoconut() et le client BasePath. |
ResourcesPath | "/doconut-res" | Emplacement d'où sont servies les ressources JS/CSS/image intégrées. |
LicensePath | "" (chaîne vide) | Chemin vers le fichier de licence. Une chaîne vide signifie passer à la source suivante, puis recherche automatique. |
LicenseContent | "" (chaîne vide) | 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é. La licence est lue pendant AddDoconut() ; redémarrez l’application après avoir remplacé une licence. |
MaxConcurrentEditorSessions | 200 | Nombre maximal de sessions d’éditeur en direct (documents ouverts avec DocOptions.EditMode). Au‑delà, la session d’éditeur inactif la moins récemment utilisée est fermée. Les sessions de visualiseur normales ne sont jamais comptées. 0 ou une valeur négative signifie aucune limite. |
EditorSnapshotEveryOps | 50 | Avec la persistance de l’éditeur activée (AddDoconutEditorPersistence), créez un instantané du document en direct toutes les N modifications enregistrées. 0 ou une valeur négative ne crée jamais d’instantané en cours de session. Aucun effet lorsque la persistance est désactivée. |
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.
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
options.MiddlewarePath = "/doconut"; // coordonnez avec le mappage de l'application et le BasePath du client
options.ResourcesPath = "/doconut-res"; // d'où les JS/CSS/images du viewer sont servis
options.UnsafeMode = false; // maintenez la sécurité de session activée
options.ShowDoconutInfo = false;
});Prochaines étapes
- Démarrage rapide — ouvrez votre premier document et affichez‑le dans le navigateur.
- Configuration de la licence — où Doconut recherche votre fichier de licence.
Cette page était-elle utile ?