Verwendung Ihrer Doconut-Lizenz

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

Doconut-Lizenzinstallation

In diesem Abschnitt erfahren 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 angegebenen Schritte, um eine nahtlose Integration Ihrer Lizenz in Ihr Projekt sicherzustellen:

.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 mithilfe eines XML-Dokuments 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";
Viewer.SetLicensePlugin(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))
{
    Viewer.SetLicensePlugin(pluginLicenseStream);
}

Plugin-Lizenz per XML-Dokument hinzufügen

Diese Methode verwendet die Überladung Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence), um eine Plugin-Lizenz mithilfe eines XML-Dokuments hinzuzufügen.

var pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
Viewer.SetLicensePlugin(pluginXmlDoc);

.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:

var docViewer = new Viewer(_cache, _accessor);

Manuelle Standardlizenz hinzufügen

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

var licenseFilePath = Path.Combine(_hostingEnvironment.WebRootPath, "path/to/your/license");
var docViewer = new Viewer(_cache, _accessor, licenseFilePath);

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 mithilfe eines XML-Dokuments hinzuzufügen.

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

Manuelle Standard-Multiple-Plugin-Lizenzen

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

List<string> licenseFilePaths = new List<string>
{
    Path.Combine(_hostingEnvironment.WebRootPath, "Doconut.Viewer.lic"),
    Path.Combine(_hostingEnvironment.WebRootPath, "Doconut.Viewer.Annotation.lic"),
    Path.Combine(_hostingEnvironment.WebRootPath, "Doconut.Viewer.Search.lic")
};
var docViewer = new Viewer(_cache, _accessor, licenseFilePaths);

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))
{
    Viewer.SetLicensePlugin(pluginLicenseStream);
}

Plugin-Lizenz per XML-Dokument hinzufügen

Diese Methode verwendet die Überladung Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence), um eine Plugin-Lizenz mithilfe eines XML-Dokuments hinzuzufügen.

var pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
Viewer.SetLicensePlugin(pluginXmlDoc);

Schutz Ihrer Lizenzdatei

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