שימוש ברישיון Doconut שלך

כדי לגלות איך להשתמש ברישיון Doconut, פעל לפי ההוראות למטה עבור פלטפורמות .NET שונות.

התקנת רישיון Doconut

בקטע זה תלמד כיצד להתקין ולהפעיל את רישיון Doconut שלך במגוון סביבות, כולל .NET Framework, .NET Standard/Core, ו‑.NET 6. עקוב אחרי הצעדים כדי להבטיח אינטגרציה חלקה של הרישיון בפרויקט שלך:

.NET Framework

זיהוי רישיון אוטומטי

Doconut יכול לזהות רישיונות באופן אוטומטי אם הם ממוקמים בתיקיית bin של הפרויקט.

הוספת רישיון ברירת מחדל ידני

אם אתה מעדיף להוסיף את הרישיון ידנית, האפשרויות הבאות זמינות:

הוספת רישיון לפי נתיב קובץ

שיטה זו משתמשת ב‑Viewer.DoconutLicense(string licencePath) כדי להוסיף רישיון על ידי ציון הנתיב לקובץ הרישיון.

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

הוספת רישיון לפי זרם

שיטה זו משתמשת ב‑Viewer.DoconutLicense(Stream licenseStream) כדי להוסיף רישיון באמצעות זרם.

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

הוספת רישיון לפי מסמך XML

שיטה זו משתמשת ב‑Viewer.DoconutLicense(XMLDocument licence) כדי להוסיף רישיון באמצעות מסמך XML.

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

הוספת רישיון תוסף לפי נתיב קובץ

שיטה זו משתמשת ב‑Viewer.SetLicensePlugin(string pathPluginLicence) כדי להוסיף רישיון תוסף על ידי ציון הנתיב לקובץ רישיון התוסף.

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

הוספת רישיון תוסף לפי זרם

שיטה זו משתמשת ב‑Viewer.SetLicensePlugin(Stream pluginLicence) כדי להוסיף רישיון תוסף באמצעות זרם.

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.

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

.NET Standard/Core ו‑.NET 6 ומעלה

זיהוי רישיון אוטומטי

Doconut יכול לזהות רישיונות באופן אוטומטי אם הם ממוקמים בתיקיית wwwroot של הפרויקט.

כדי לאתחל את docViewer עם זיהוי רישיון אוטומטי, השתמש בשורה הבאה:

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

הוספת רישיון ברירת מחדל ידני

אתה יכול לציין ידנית את הנתיב לקובץ רישיון ברירת מחדל יחיד בעת אתחול הצופה.

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

הוספת רישיון לפי זרם

שיטה זו משתמשת ב‑Viewer.DoconutLicense(Stream licenseStream) כדי להוסיף רישיון באמצעות זרם.

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

הוספת רישיון לפי מסמך XML

שיטה זו משתמשת ב‑Viewer.DoconutLicense(XMLDocument licence) כדי להוסיף רישיון באמצעות מסמך XML.

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

var xmlDoc = new XmlDocument();
xmlDoc.Load("path/to/your/license.xml");
var license = new DoconutLicense(); // לאכלס מאפיינים מ‑xmlDoc לפי הצורך

רישיונות תוסף מרובים (ברירת מחדל) ידניים

אם אתה צריך לציין רישיונות מרובים, אתה יכול לספק רשימת נתיבי קבצים לאתחול הצופה.

// הרשיונות מוגדרים דרך הזרקת תלות; אין צורך בבנאי מפורש.
var viewer = /* מופע Viewer שנפתר על‑ידי DI */ null;

הוספת רישיון תוסף לפי זרם

שיטה זו משתמשת ב‑Viewer.SetLicensePlugin(Stream pluginLicence) כדי להוסיף רישיון תוסף באמצעות זרם.

using var licenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open);
var config = new BaseConfig(); // זרם הרישיון נצרך פנימית על‑ידי BaseConfig

הוספת רישיון תוסף לפי מסמך XML

שיטה זו משתמשת ב‑Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) כדי להוסיף רישיון תוסף באמצעות מסמך XML.

using System.Xml;
var pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
// טעינת הרישיון אינה נדרשת יותר ב‑Doconut.NETStandard 26.9.0

הגנת קובץ הרישיון שלך

כדי להגן על קובץ הרישיון Doconut שלך (.lic), חשוב לעקוב אחרי שיטות הטובה ביותר לאבטחת קבצים. שמור את קובץ הרישיון בתיקייה מאובטחת עם גישה מוגבלת, כך שרק משתמשים או שירותים מורשים יוכלו לקרוא אותו.