Licensing

كيفية تقديم طلب ترخيص في مكون Aspose.Cells

الترخيص عبارة عن ملف XML نصي عادي يحتوي على تفاصيل مثل اسم المنتج وعدد المطورين المرخص لهم وتاريخ انتهاء صلاحية الاشتراك وما إلى ذلك. الملف موقع رقميًا، لذا لا تقم بتعديل الملف. حتى الإضافة غير المقصودة لفاصل أسطر إضافي في الملف ستؤدي إلى إبطاله. تحتاج إلى تعيين ترخيص قبل استخدام Aspose.Cells إذا كنت تريد تجنب قيود التقييم الخاصة به. مطلوب فقط تعيين ترخيص مرة واحدة لكل تطبيق (أو عملية). يمكن تحميل الترخيص من ملف أو دفق أو مورد مضمن.

Aspose.Cells يحاول العثور على الترخيص في المواقع التالية:

• المسار الصريح
• المجلد الذي يحتوي على Aspose.Cells.dll
• المجلد الذي يحتوي على التجميع الذي يسمى Aspose.Cells.dll
• المجلد الذي يحتوي على مجموعة الإدخال (ملف exe.)
• مورد مضمن في التجميع يسمى Aspose.Cells.dll

هناك طريقتان شائعتان لتطبيق الترخيص، من ملف أو دفق، أو كمورد مضمن.

كيفية تطبيق ترخيص من القرص أو الدفق

أسهل طريقة لتعيين ترخيص هي وضع ملف الترخيص في نفس المجلد مثل ملف Aspose.Cells.dll وتحديد اسم الملف فقط بدون مساره.

 //Instantiate an instance of license and set the license file through its path

Aspose.Cells.License license = new Aspose.Cells.License();

license.SetLicense("Aspose.Cells.lic");

عند استدعاء الأسلوب SetLicense، يجب أن يكون اسم الترخيص هو نفس اسم ملف الترخيص الخاص بك. على سبيل المثال، يمكنك تغيير اسم ملف الترخيص إلى Aspose.Cells.lic.xml*. ثم في التعليمات البرمجية الخاصة بك، يجب عليك استخدام اسم الترخيص المعدل (**Aspose.Cells.lic.xml**) لأسلوب SetLicense.

من الممكن أيضًا تحميل ترخيص من الدفق.

 //Instantiate an instance of license and set the license through a stream

Aspose.Cells.License license = new Aspose.Cells.License();

license.SetLicense(myStream);

كيفية تطبيق الترخيص المقنن

Aspose.Cells يسمح للمطورين بتطبيق المفتاح المقنن. إنها آلية ترخيص جديدة. وسيتم استخدام آلية الترخيص الجديدة إلى جانب طريقة الترخيص الحالية. يمكن لهؤلاء العملاء الذين يريدون أن تتم محاسبتهم على أساس استخدام ميزات API استخدام الترخيص المقنن. لمزيد من التفاصيل، يرجى الرجوع إلىعداد Licensing الأسئلة الشائعةقسم.

فئة جديدةمقننةتم تقديمه لتطبيق المفتاح المقنن. فيما يلي نموذج التعليمات البرمجية الذي يوضح كيفية تعيين المفتاح العام والخاص.

 //Set metered public and private keys

Metered metered = new Metered();

//Access the setMeteredKey property and pass public and private keys as parameters

metered.SetMeteredKey("*************", "*************");

//Instantiate a new Workbook

Workbook workbook = new Workbook();

//Check if the license is set

Console.WriteLine(workbook.IsLicensed);

//Get the Consumption quantity

decimal amountBefore = Metered.GetConsumptionQuantity();

Console.WriteLine(amountBefore);

Workbook workbook2 = new Workbook("e:\\test2\\Book1.xlsx");

workbook2.Save("e:\\test2\\out1.xlsx");

//Since uploading data is already running on another thread, so you might need to wait for some time (optional)

System.Threading.Thread.Sleep(10000);

//Get the Consumption quantity again which should be greater a bit

decimal amountAfter = Metered.GetConsumptionQuantity();

Console.WriteLine(amountAfter);

كيفية استخدام الموارد المضمنة

هناك طريقة أخرى أنيقة لتعبئة الترخيص مع التطبيق الخاص بك والتأكد من عدم فقدانه، وهي تضمينه كمورد مضمن في إحدى التجميعات التي تستدعي Aspose.Cells. لتضمين ملف الترخيص كمورد مضمن، قم بتنفيذ الخطوات التالية :

1. في Visual Studio .NET، قم بتضمين ملف الترخيص (.lic) في المشروع عن طريق التحديدإضافة عنصر موجود منملف قائمة طعام.
2. حدد الملف في Solution Explorer وقم بتعيينهبناء العمل لالموارد المضمنة في نافذة الخصائص

للوصول إلى الترخيص المضمن في التجميع (كمورد مضمن)، ليس من الضروري استدعاء أساليب GetExecutingAssembly وGetManifestResourceStream لفئة System.Reflection.Assembly من Microsoft .NET Framework. كل ما عليك فعله هو إضافة ملف الترخيص كمورد مضمن إلى مشروعك وتمرير اسم ملف الترخيص إلى طريقة SetLicense. الAspose.Cells.License سيجد الفصل تلقائيًا ملف الترخيص في الموارد المضمنة. يرجى مراجعة المثال الموضح أدناه لفهم طريقة تعيين الترخيص (المضمن) في تطبيقاتك.

 //Instantiate the License class

Aspose.Cells.License license = new Aspose.Cells.License();

//Pass only the name of the license file embedded in the assembly

license.SetLicense("Aspose.Cells.lic");

كيفية تعيين الترخيص في Aspose.Cells ضوابط الشبكة

في Aspose.Cells Grid Suite، يمكن تحميل الترخيص من ملف أو دفق أو مورد مضمن. Aspose.Cells.GridDesktop / Aspose.Cells.GridWeb يحاول العثور على الترخيص في المواقع التالية:

1. المسار الصريح
2. المجلد الذي يحتوي على ملف dll للمكون (المضمن في Aspose.Cells.GridDesktop أو Aspose.Cells.GridWeb)
3. المجلد الذي يحتوي على التجميع الذي يسمى ملف dll للمكون (المضمن في Aspose.Cells.GridDesktop أو Aspose.Cells.GridWeb)
4. المجلد الذي يحتوي على مجموعة الإدخال (ملف exe.)
5. مورد مضمن في التجميع يسمى ملف dll للمكون (مضمن في Aspose.Cells.GridDesktop أو Aspose.Cells.GridWeb)

إذا كنت تستخدم عنصر التحكم Aspose.Cells.GridDesktop، فسيتم استخدام فئة الترخيص كـ Aspose.Cells.GridDesktop.License ولكن إذا كنت تستخدم عنصر التحكم Aspose.Cells.GridWeb، فسيتم استخدام فئة الترخيص Aspose.Cells.GridWeb.License لتعيين الترخيص.

كيفية تطبيق ترخيص من القرص أو الدفق

أسهل طريقة لتعيين ترخيص هي وضع ملف الترخيص في نفس المجلد مثل ملف dll الخاص بالمكون (المضمن في Aspose.Cells.GridWeb) وتحديد اسم الملف فقط دون مساره.

//Instantiate an instance of license and set the license file through its path

Aspose.Cells.GridWeb.License license = new Aspose.Cells.GridWeb.License();

license.SetLicense("MyLicense.lic");

عند استدعاء أسلوب SetLicense، يجب أن يكون اسم الترخيص هو نفس اسم ملف الترخيص الخاص بك. على سبيل المثال، يمكنك تغيير اسم ملف الترخيص إلى “MyLicense.lic.xml”. بعد ذلك، في التعليمات البرمجية الخاصة بك، يجب عليك استخدام اسم الترخيص المعدل (أي MyLicense.lic.xml) لأسلوب SetLicense.

من الممكن أيضًا تحميل ترخيص من الدفق.

//Instantiate an instance of license and set the license through a stream

Aspose.Cells.GridWeb.License license = new Aspose.Cells.GridWeb.License();

license.SetLicense(myStream);

كيفية تطبيق الترخيص كمورد مضمن

هناك طريقة أخرى أنيقة لتعبئة الترخيص مع تطبيقك والتأكد من عدم فقدانه، وهي تضمينه كمورد مضمن في إحدى التجميعات التي تستدعي ملف dll الخاص بالمكون (المضمن في Aspose.Cells.GridDesktop). لتضمين ملف الترخيص كمورد مضمن، قم بتنفيذ الخطوات التالية:

1. في Visual Studio .NET، قم بتضمين ملف الترخيص (.lic) في المشروع باستخدام الملفإضافة عنصر موجود الخيار علىملف قائمة طعام.
2. حدد الملف في Solution Explorer وقم بتعيين Build Action على Embedded Resource في نافذة الخصائص.
3. للوصول إلى الترخيص المضمن في التجميع (كمورد مضمن)، ليس من الضروري استدعاء أساليب GetExecutingAssembly وGetManifestResourceStream للفئة System.Reflection.Assembly من Microsoft .NET Framework. بدلاً من ذلك، قم بإضافة ملف الترخيص كمورد مضمن في المشروع وتمرير اسم ملف الترخيص إلى أسلوب SetLicense. تقوم فئة الترخيص تلقائيًا بالعثور على ملف الترخيص في الموارد المضمنة.

يرجى مراجعة المثال الموضح أدناه لفهم هذه الطريقة لتطبيق الترخيص كمورد مضمن لتطبيقاتك.

 //Instantiate the License class

Aspose.Cells.GridDesktop.License license = new Aspose.Cells.GridDesktop.License();

//Pass only the name of the license file embedded in the assembly

license.SetLicense("Aspose.Total.lic");

كيفية تطبيق ترخيص في Aspose.Cells.GridDesktop لتطبيق WinForm

يوصى بوضع رمز الترخيص الخاص بك قبل بدء تشغيل التطبيق الخاص بك وتطبيقه مرة واحدة فقط. على سبيل المثال، بالنسبة لتطبيق Windows C#، ضع رمز الترخيص في الطريقة الرئيسية.

public class Form1 : System.Windows.Forms.Form

{

private Aspose.Cells.GridDesktop.GridDesktop gridDesktop1;

/// <summary>

/// Required designer variable.

/// </summary>

private System.ComponentModel.Container components = null;

public Form1()

{

//

// Required for Windows Form Designer support

//

InitializeComponent();

//

// TODO: Add any constructor code after InitializeComponent call

//

}

/// The main entry point for the application.

/// </summary>

.

.

.

.

[STAThread]

static void Main()

{

Aspose.Cells.GridDesktop.License lic = new Aspose.Cells.GridDesktop.License();

//Use this line if you are using an explicit path for the license file.

lic.SetLicense(@"C:\MyLicense.lic");

//Or use the line below if you are using the license file as an embedded resource.

//lic.SetLicense("MyLicense.lic");

Application.Run(new Form1());

}

private void Form1_Load(object sender, System.EventArgs e)

{

Aspose.Cells.GridDesktop.Worksheet sheet = this.gridDesktop1.Worksheets.Add("MySheet");

sheet.Cells["A1"].SetCellValue("Hello");

gridDesktop1.ActiveSheetIndex = 1;

}

}

ملاحظات حول تطبيق الترخيص في Aspose.Cells.GridWeb

من المستحسن وضع رمز الترخيص في Global.asax.cs لتطبيق الويب الخاص بك (من المفترض أن يتم وضع ملف الترخيص هذا على محرك الأقراص " d:\ “):

 protected void Application_Start(Object sender, EventArgs e)

{

    Aspose.Cells.GridWeb.License lic = new Aspose.Cells.GridWeb.License();

    lic.SetLicense(@"d:\Aspose.Cells.GridWeb.lic.xml");

}

تحميل ترخيص من الدفق

 protected void Application_Start(Object sender, EventArgs e)

{

    Aspose.Cells.GridWeb.License lic = new Aspose.Cells.GridWeb.License();

    lic.SetLicense(myStream);

}