Licensing

Come applicare una licenza nel componente Aspose.Cells

La licenza è un file XML di testo semplice che contiene dettagli come il nome del prodotto, il numero di sviluppatori a cui è concessa la licenza, la data di scadenza dell’abbonamento e così via. Il file è firmato digitalmente, quindi non modificare il file. Anche l’aggiunta involontaria di un’interruzione di riga aggiuntiva nel file lo invaliderà. È necessario impostare una licenza prima di utilizzare Aspose.Cells se si desidera evitare la limitazione della valutazione. È necessario impostare una licenza solo una volta per applicazione (o processo). La licenza può essere caricata da un file, un flusso o una risorsa incorporata.

Aspose.Cells tenta di trovare la licenza nelle seguenti posizioni:

  • Percorso esplicito
  • La cartella che contiene Aspose.Cells.dll
  • La cartella che contiene l’assembly che ha chiamato Aspose.Cells.dll
  • La cartella che contiene l’assembly della voce (il tuo .exe)
  • Una risorsa incorporata nell’assembly che ha chiamato Aspose.Cells.dll

Esistono due metodi comuni per applicare una licenza: da file o flusso o come risorsa incorporata.

Come applicare una licenza da disco o flusso

Il modo più semplice per impostare una licenza è inserire il file di licenza nella stessa cartella di Aspose.Cells.dll e specificare solo il nome del file senza il percorso.

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

È anche possibile caricare una licenza da uno stream.

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

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

license.SetLicense(myStream);

Come applicare la licenza a consumo

Aspose.Cells consente agli sviluppatori di applicare la chiave a consumo. Si tratta di un nuovo meccanismo di concessione delle licenze. Il nuovo meccanismo di licenza verrà utilizzato insieme al metodo di licenza esistente. I clienti che desiderano ricevere una fattura in base all’utilizzo delle funzionalità API possono utilizzare la licenza a consumo. Per ulteriori dettagli, fare riferimento aCon tassametro Licensing FAQsezione.

Una nuova classeMisuratoè stato introdotto per applicare la chiave misurata. Di seguito è riportato il codice di esempio che mostra come impostare la chiave pubblica e privata misurata.

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

Come utilizzare una risorsa incorporata

Un altro modo efficace per comprimere la licenza con l’applicazione e assicurarsi che non vada persa è includerla come risorsa incorporata in uno degli assembly che chiama Aspose.Cells. Per includere il file di licenza come risorsa incorporata, eseguire i seguenti passaggi :

  1. In Visual Studio .NET includere il file di licenza (.lic) nel progetto selezionandoloAggiungi elemento esistente dalFile menù.
  2. Selezionare il file in Solution Explorer e impostareCostruisci azione ARisorsa incorporata nella finestra Proprietà

Per accedere alla licenza incorporata nell’assembly (come risorsa incorporata), non è necessario chiamare i metodi GetExecutingAssembly e GetManifestResourceStream della classe System.Reflection.Assembly di Microsoft .NET Framework. Tutto quello che devi fare è semplicemente aggiungere il file di licenza come risorsa incorporata al tuo progetto e passare il nome del file di licenza nel metodo SetLicense. ILAspose.Cells.License class troverà automaticamente il file di licenza nelle risorse incorporate. Si prega di rivedere l’esempio fornito di seguito per comprendere questo metodo di impostazione della licenza (incorporata) nelle proprie applicazioni.

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

Come impostare la licenza nei controlli della griglia Aspose.Cells

In Aspose.Cells Grid Suite, la licenza può essere caricata da un file, stream o una risorsa incorporata. Aspose.Cells.GridDesktop / Aspose.Cells.GridWeb tenta di trovare la licenza nelle seguenti posizioni:

  1. Percorso esplicito
  2. La cartella che contiene la dll del componente (compresa in Aspose.Cells.GridDesktop o Aspose.Cells.GridWeb)
  3. La cartella che contiene l’assembly che ha chiamato la dll del componente (incluso in Aspose.Cells.GridDesktop o Aspose.Cells.GridWeb)
  4. La cartella che contiene l’assembly della voce (il tuo .exe)
  5. Una risorsa incorporata nell’assembly che ha chiamato la dll del componente (inclusa in Aspose.Cells.GridDesktop o Aspose.Cells.GridWeb)

Come applicare una licenza da disco o flusso

Il modo più semplice per impostare una licenza è mettere il file di licenza nella stessa cartella della dll del componente (inclusa in Aspose.Cells.GridWeb) e specificare solo il nome del file senza il suo percorso.

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

È anche possibile caricare una licenza da uno stream.

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

Come applicare una licenza come risorsa incorporata

Un altro modo accurato per confezionare la licenza con la tua applicazione e assicurarti che non vada persa, è includerla come risorsa incorporata in uno degli assembly che chiama la dll del componente (incluso in Aspose.Cells.GridDesktop). Per includere il file di licenza come risorsa incorporata, effettuare le seguenti operazioni:

  1. In Visual Studio .NET includere il file di licenza (.lic) nel progetto utilizzando l’estensioneAggiungi elemento esistente opzione suFile menù.
  2. Selezionare il file in Esplora soluzioni e impostare Azione di compilazione su Risorsa incorporata nella finestra Proprietà.
  3. Per accedere alla licenza incorporata nell’assembly (come risorsa incorporata), non è necessario chiamare i metodi GetExecutingAssembly e GetManifestResourceStream della classe System.Reflection.Assembly di Microsoft .NET Framework. Aggiungi invece il file di licenza come risorsa incorporata nel tuo project e passare il nome del file di licenza nel metodo SetLicense. La classe License trova automaticamente il file di licenza nelle risorse incorporate.

Ti preghiamo di rivedere l’esempio fornito di seguito per comprendere questo metodo di applicazione di una licenza come risorsa incorporata alle tue applicazioni.

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

Come applicare una licenza in Aspose.Cells.GridDesktop per un’applicazione WinForm

Si consiglia di inserire il codice di licenza prima dell’avvio dell’applicazione e di applicarlo solo una volta. Ad esempio, per un’applicazione Windows C#, inserisci il codice di licenza nel metodo Main.

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;

}

}

Note sull’applicazione di una licenza in Aspose.Cells.GridWeb

Si consiglia di inserire il codice di licenza nel Global.asax.cs della tua applicazione web (si presuppone che questo file di licenza sia inserito nell’unità " 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");

}

Caricamento di una licenza da uno stream

 protected void Application_Start(Object sender, EventArgs e)

{

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

    lic.SetLicense(myStream);

}