Verwendung Ihrer Doconut-Lizenz

Um herauszufinden, wie Sie eine Doconut-Lizenz verwenden, folgen Sie den untenstehenden Anweisungen für verschiedene .NET-Plattformen.

Doconut-Lizenzinstallation

In diesem Abschnitt lernen Sie, wie Sie Ihre Doconut-Lizenz in verschiedenen Umgebungen installieren und aktivieren, einschließlich .NET Framework, .NET Standard/Core und .NET 6. Befolgen Sie die bereitgestellten Schritte, um eine nahtlose Integration Ihrer Lizenz in Ihr Projekt zu gewährleisten:

.NET Framework

Automatische Lizenz-Erkennung

Doconut kann Lizenzen automatisch erkennen, wenn sie im bin-Ordner des Projekts abgelegt werden.

Manuelle Standardlizenz hinzufügen

Wenn Sie die Lizenz manuell hinzufügen möchten, stehen die folgenden Optionen zur Verfügung:

Lizenz per Dateipfad hinzufügen

Diese Methode verwendet die Überladung Viewer.DoconutLicense(string licencePath), um eine Lizenz hinzuzufügen, indem der Pfad zur Lizenzdatei angegeben wird.

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

Lizenz per Stream hinzufügen

Diese Methode verwendet die Überladung Viewer.DoconutLicense(Stream licenseStream), um eine Lizenz über einen Stream hinzuzufügen.

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

Lizenz per XML-Dokument hinzufügen

Diese Methode verwendet die Überladung Viewer.DoconutLicense(XMLDocument licence), um eine Lizenz mit einem XML-Dokument hinzuzufügen.

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

Plugin-Lizenz per Dateipfad hinzufügen

Diese Methode verwendet die Überladung Viewer.SetLicensePlugin(string pathPluginLicence), um eine Plugin-Lizenz hinzuzufügen, indem der Pfad zur Plugin-Lizenzdatei angegeben wird.

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

Plugin-Lizenz per Stream hinzufügen

Diese Methode verwendet die Überladung Viewer.SetLicensePlugin(Stream pluginLicence), um eine Plugin-Lizenz über einen Stream hinzuzufügen.

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

Plugin-Lizenz per XML-Dokument hinzufügen

Diese Methode verwendet die Überladung Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence), um eine Plugin-Lizenz mit einem XML-Dokument hinzuzufügen.

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

.NET Standard/Core und .NET 6 und höher

Automatische Lizenz-Erkennung

Doconut kann Lizenzen automatisch erkennen, wenn sie im wwwroot-Ordner des Projekts abgelegt werden.

Um den docViewer mit automatischer Lizenz-Erkennung zu initialisieren, verwenden Sie die folgende Zeile:

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

Manuelle Standardlizenz hinzufügen

Sie können beim Initialisieren des Viewers den Pfad zu einer einzelnen Standardlizenzdatei manuell angeben.

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

Lizenz per Stream hinzufügen

Diese Methode verwendet die Überladung Viewer.DoconutLicense(Stream licenseStream), um eine Lizenz über einen Stream hinzuzufügen.

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

Lizenz per XML-Dokument hinzufügen

Diese Methode verwendet die Überladung Viewer.DoconutLicense(XMLDocument licence), um eine Lizenz mit einem XML-Dokument hinzuzufügen.

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

var xmlDoc = new XmlDocument();
xmlDoc.Load("path/to/your/license.xml");
var license = new DoconutLicense(); // Eigenschaften nach Bedarf aus xmlDoc befüllen

Manuelle Standardmehrfach-Plugin-Lizenzen

Wenn Sie mehrere Lizenzen angeben müssen, können Sie dem Viewer bei der Initialisierung eine Liste von Dateipfaden bereitstellen.

// Lizenzen werden über Dependency Injection konfiguriert; ein expliziter Konstruktor ist nicht erforderlich.
var viewer = /* DI‑aufgelöste Viewer-Instanz */ null;

Plugin-Lizenz per Stream hinzufügen

Diese Methode verwendet die Überladung Viewer.SetLicensePlugin(Stream pluginLicence), um eine Plugin-Lizenz über einen Stream hinzuzufügen.

using var licenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open);
var config = new BaseConfig(); // Der Lizenz-Stream wird intern von BaseConfig verbraucht

Plugin-Lizenz per XML-Dokument hinzufügen

Diese Methode verwendet die Überladung Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence), um eine Plugin-Lizenz mit einem XML-Dokument hinzuzufügen.

using System.Xml;
var pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
// Das Laden von Lizenzen ist in Doconut.NETStandard 26.9.0 nicht mehr erforderlich

Schutz Ihrer Lizenzdatei

Um Ihre Doconut-Lizenzdatei (.lic) zu schützen, ist es wichtig, bewährte Sicherheitspraktiken für Dateien zu befolgen. Speichern Sie die Lizenzdatei in einem sicheren Verzeichnis mit eingeschränktem Zugriff, sodass nur autorisierte Benutzer oder Dienste sie lesen können.