Χρήση της Άδειας Doconut – Doconut Τεκμηρίωση

Για να μάθετε πώς να χρησιμοποιήσετε μια άδεια Doconut, ακολουθήστε τις παρακάτω οδηγίες για διαφορετικές πλατφόρμες .NET.

Εγκατάσταση Άδειας Doconut

Σε αυτήν την ενότητα, θα μάθετε πώς να εγκαταστήσετε και να ενεργοποιήσετε την άδεια Doconut σε διάφορα περιβάλλοντα, συμπεριλαμβανομένων των .NET Framework, .NET Standard/Core και .NET 6. Ακολουθήστε τα βήματα που παρέχονται για να εξασφαλίσετε την απρόσκοπτη ενσωμάτωση της άδειας στο έργο σας:

.NET Framework

Αυτόματη Ανίχνευση Άδειας

Το Doconut μπορεί να ανιχνεύσει αυτόματα τις άδειες εάν τοποθετηθούν στον φάκελο bin του έργου.

Προσθήκη Προεπιλεγμένης Άδειας Χειροκίνητα

Εάν προτιμάτε να προσθέσετε την άδεια χειροκίνητα, είναι διαθέσιμες οι παρακάτω επιλογές:

Προσθήκη Άδειας με Διαδρομή Αρχείου

Αυτή η μέθοδος χρησιμοποιεί την υπερφόρτωση Viewer.DoconutLicense(string licencePath) για να προσθέσει μια άδεια καθορίζοντας τη διαδρομή του αρχείου άδειας.

csharp

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

Προσθήκη Άδειας με Ροή

Αυτή η μέθοδος χρησιμοποιεί την υπερφόρτωση Viewer.DoconutLicense(Stream licenseStream) για να προσθέσει μια άδεια χρησιμοποιώντας μια ροή.

csharp

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

Προσθήκη Άδειας με Έγγραφο XML

Αυτή η μέθοδος χρησιμοποιεί την υπερφόρτωση Viewer.DoconutLicense(XMLDocument licence) για να προσθέσει μια άδεια χρησιμοποιώντας ένα έγγραφο XML.

csharp

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

Προσθήκη Άδειας Πρόσθετου με Διαδρομή Αρχείου

Αυτή η μέθοδος χρησιμοποιεί την υπερφόρτωση Viewer.SetLicensePlugin(string pathPluginLicence) για να προσθέσει μια άδεια πρόσθετου καθορίζοντας τη διαδρομή του αρχείου άδειας του πρόσθετου.

csharp

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

Προσθήκη Άδειας Πρόσθετου με Ροή

Αυτή η μέθοδος χρησιμοποιεί την υπερφόρτωση Viewer.SetLicensePlugin(Stream pluginLicence) για να προσθέσει μια άδεια πρόσθετου χρησιμοποιώντας μια ροή.

csharp

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

Προσθήκη Άδειας Πρόσθετου με Έγγραφο XML

Αυτή η μέθοδος χρησιμοποιεί την υπερφόρτωση Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) για να προσθέσει μια άδεια πρόσθετου χρησιμοποιώντας ένα έγγραφο XML.

csharp

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

.NET Standard/Core και .NET 6 και νεότερα

Αυτόματη Ανίχνευση Άδειας

Το Doconut μπορεί να ανιχνεύσει αυτόματα τις άδειες εάν τοποθετηθούν στον φάκελο wwwroot του έργου.

Για να αρχικοποιήσετε το docViewer με αυτόματη ανίχνευση άδειας, χρησιμοποιήστε την παρακάτω γραμμή:

csharp

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

Προσθήκη Προεπιλεγμένης Άδειας Χειροκίνητα

Μπορείτε να καθορίσετε χειροκίνητα τη διαδρομή ενός μοναδικού προεπιλεγμένου αρχείου άδειας κατά την αρχικοποίηση του προβολέα.

csharp

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

Προσθήκη Άδειας με Ροή

csharp

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

Προσθήκη Άδειας με Έγγραφο XML

csharp

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

var xmlDoc = new XmlDocument();
xmlDoc.Load("path/to/your/license.xml");
var license = new DoconutLicense(); // συμπλήρωση ιδιοτήτων από το xmlDoc όπως απαιτείται

Προεπιλεγμένες Πολλαπλές Άδειες Πρόσθετου Χειροκίνητα

Εάν χρειάζεται να καθορίσετε πολλαπλές άδειες, μπορείτε να παρέχετε μια λίστα διαδρομών αρχείων στην αρχικοποίηση του προβολέα.

csharp

// Οι άδειες διαμορφώνονται μέσω dependency injection; δεν απαιτείται ρητός κατασκευαστής.
var viewer = /* DI‑resolved Viewer αντικείμενο */ null;

Προσθήκη Άδειας Πρόσθετου με Ροή

csharp

using var licenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open);
var config = new BaseConfig(); // η ροή άδειας καταναλώνεται εσωτερικά από το BaseConfig

Προσθήκη Άδειας Πρόσθετου με Έγγραφο XML

csharp

using System.Xml;
var pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
// Η φόρτωση License δεν απαιτείται πλέον στο Doconut.NETStandard 26.9.0

Προστασία του Αρχείου Άδειας Σας

Για να προστατεύσετε το αρχείο άδειας Doconut (.lic), είναι απαραίτητο να ακολουθήσετε τις βέλτιστες πρακτικές ασφαλείας αρχείων. Αποθηκεύστε το αρχείο άδειας σε ασφαλή κατάλογο με περιορισμένη πρόσβαση, διασφαλίζοντας ότι μόνο εξουσιοδοτημένοι χρήστες ή υπηρεσίες μπορούν να το διαβάσουν.