Licensing

Limitazioni della versione di valutazione

La versione di valutazione del prodotto Aspose.Cells (senza una licenza specificata) fornisce la funzionalità completa del prodotto, ma è limitata all’apertura di 100 file in un programma e un foglio di lavoro aggiuntivo con filigrana di valutazione.

Le limitazioni sono riportate di seguito:

  • Numero di file aperti (Aspose.Cells) Quando esegui il programma, puoi aprire solo 100 file Excel utilizzando la libreria Aspose.Cells. Se la tua domanda supera questo numero, verrà generata un’eccezione.
  • Impostazioni del file di configurazione(Aspose.Cells.GridWeb) Non è possibile specificare nuovamente il percorso dello script aggiungendo le seguenti righe di codice nella sezione di configurazione (ad esempio nel file web.config). acw_client è una cartella che contiene file e Aspose.Cells.GridWeb utilizza questa cartella per gestire la sua configurazione interna, ha file di script, file di immagine e altri file per specificare il comportamento di GridWeb e impostare altre operazioni. Il file di configurazione viene utilizzato per impedire al controllo di utilizzare le risorse client integrate (immagini, script e così via), il che è utile in alcuni casi/scenari. Inoltre, queste impostazioni di configurazione nel file web.config avranno effetto solo con la versione CON LICENZA del controllo.

XML

 <appSettings>

<add key="aspose.cells.gridweb.acw_client_path" value="/acw_client/" />

<add key="aspose.cells.gridweb.force_script_path" value="true" />

</appSettings>

Inoltre, un foglio di lavoro con filigrana di valutazione verrà sempre visualizzato come foglio di lavoro attivo nel file Excel generato utilizzando la libreria Aspose.Cells. Solo nella versione con licenza è possibile impostare il foglio di lavoro attivo su altri fogli di lavoro. Nell’output PDF o nel file immagine di Aspose.Cells, una filigrana di valutazione verrebbe incollata nella parte superiore del documento/immagine. Non è possibile nascondere l’avviso sul copyright di valutazione (il foglio di lavoro aggiuntivo) anche nel controllo GridWeb, verrà sempre aggiunto (alla fine nelle schede del foglio di lavoro) nel controllo.

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

}