Utilisation de votre licence Doconut

Pour découvrir comment utiliser une licence Doconut, suivez les instructions ci‑dessous pour les différentes plateformes .NET.

Installation de la licence Doconut

Dans cette section, vous apprendrez comment installer et activer votre licence Doconut dans divers environnements, y compris .NET Framework, .NET Standard/Core et .NET 6. Suivez les étapes fournies afin d’assurer une intégration fluide de votre licence dans votre projet :

.NET Framework

Détection automatique de la licence

Doconut peut détecter automatiquement les licences si elles sont placées dans le dossier bin du projet.

Ajouter une licence par défaut manuelle

Si vous préférez ajouter la licence manuellement, les options suivantes sont disponibles :

Ajouter une licence par chemin de fichier

Cette méthode utilise la Viewer.DoconutLicense(string licencePath) surcharge pour ajouter une licence en spécifiant le chemin du fichier de licence.

var licensePath = "path/to/your/license.lic";
Viewer.DoconutLicense(licensePath);

Ajouter une licence par flux

Cette méthode utilise la Viewer.DoconutLicense(Stream licenseStream) surcharge pour ajouter une licence à l’aide d’un flux.

using (var licenseStream = new FileStream("path/to/your/license", FileMode.Open))
{
    Viewer.DoconutLicense(licenseStream);
}

Ajouter une licence par document XML

Cette méthode utilise la Viewer.DoconutLicense(XMLDocument licence) surcharge pour ajouter une licence à l’aide d’un document XML.

var xmlDoc = new XmlDocument();
xmlDoc.Load("path/to/your/license.xml");
Viewer.DoconutLicense(xmlDoc);

Ajouter une licence de plugin par chemin de fichier

Cette méthode utilise la Viewer.SetLicensePlugin(string pathPluginLicence) surcharge pour ajouter une licence de plugin en spécifiant le chemin du fichier de licence du plugin.

var pluginLicensePath = "path/to/your/plugin-license.lic";
new Viewer().DoconutLicense(pluginLicensePath);

Ajouter une licence de plugin par flux

Cette méthode utilise la Viewer.SetLicensePlugin(Stream pluginLicence) surcharge pour ajouter une licence de plugin à l’aide d’un flux.

using var pluginLicenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open);
var viewer = new Doconut.Viewer();
viewer.DoconutLicense(pluginLicenseStream);

Ajouter une licence de plugin par document XML

Cette méthode utilise la Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) surcharge pour ajouter une licence de plugin à l’aide d’un document XML.

var viewer = new Viewer();
viewer.DoconutLicense("path/to/your/plugin-license.xml");

.NET Standard/Core et .NET 6 et versions supérieures

Détection automatique de la licence

Doconut peut détecter automatiquement les licences si elles sont placées dans le dossier wwwroot du projet.

Pour initialiser le docViewer avec la détection automatique de licence, utilisez la ligne suivante :

using Microsoft.Extensions.DependencyInjection;
var docViewer = app.Services.GetRequiredService<Doconut.Viewer>();

Ajouter une licence par défaut manuelle

Vous pouvez spécifier manuellement le chemin d’un seul fichier de licence par défaut lors de l’initialisation du visualiseur.

using System.IO;
var licenseFilePath = Path.Combine(path, "path/to/your/license");
var token = await viewer.OpenDocumentAsync(licenseFilePath, new BaseConfig(), new DocOptions(), ct);

Ajouter une licence par flux

Cette méthode utilise la Viewer.DoconutLicense(Stream licenseStream) surcharge pour ajouter une licence à l’aide d’un flux.

using (var licenseStream = new FileStream("path/to/your/license", FileMode.Open))
{
    var license = new DoconutLicense
    {
        DocBytes = new BinaryReader(licenseStream).ReadBytes((int)licenseStream.Length)
    };
}

Ajouter une licence par document XML

Cette méthode utilise la Viewer.DoconutLicense(XMLDocument licence) surcharge pour ajouter une licence à l’aide d’un document XML.

using System.Xml;
using Doconut.Infrastructure.Licensing;

var xmlDoc = new XmlDocument();
xmlDoc.Load("path/to/your/license.xml");
var license = new DoconutLicense(); // remplir les propriétés à partir de xmlDoc selon les besoins

Licence multiple de plugin par défaut manuelle

Si vous devez spécifier plusieurs licences, vous pouvez fournir une liste de chemins de fichiers lors de l’initialisation du visualiseur.

// Les licences sont configurées via l'injection de dépendances ; aucun constructeur explicite n'est requis.
var viewer = /* Instance Viewer résolue par DI */ null;

Ajouter une licence de plugin par flux

Cette méthode utilise la Viewer.SetLicensePlugin(Stream pluginLicence) surcharge pour ajouter une licence de plugin à l’aide d’un flux.

using var licenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open);
var config = new BaseConfig(); // le flux de licence est consommé en interne par BaseConfig

Ajouter une licence de plugin par document XML

Cette méthode utilise la Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) surcharge pour ajouter une licence de plugin à l’aide d’un document XML.

using System.Xml;
var pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
// Le chargement de licence n'est plus nécessaire dans Doconut.NETStandard 26.9.0

Protection de votre fichier de licence

Pour protéger votre fichier de licence Doconut (.lic), il est essentiel de suivre les meilleures pratiques en matière de sécurité des fichiers. Conservez le fichier de licence dans un répertoire sécurisé avec un accès restreint, en veillant à ce que seuls les utilisateurs ou services autorisés puissent le lire.