Χρήση της Άδειας 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";
Viewer.SetLicensePlugin(pluginLicensePath);

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

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

csharp

using (var pluginLicenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open))
{
    Viewer.SetLicensePlugin(pluginLicenseStream);
}

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

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

csharp

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

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

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

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

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

csharp

var docViewer = new Viewer(_cache, _accessor);

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

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

csharp

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

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

csharp

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

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

csharp

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

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

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

csharp

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);

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

csharp

using (var pluginLicenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open))
{
    Viewer.SetLicensePlugin(pluginLicenseStream);
}

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

csharp

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

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

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