Licence
Limites de la version d’évaluation
La version d’évaluation du produit Aspose.Cells (sans licence spécifiée) fournit toutes les fonctionnalités du produit, mais elle est limitée à l’ouverture de 100 fichiers dans un programme et d’une feuille de calcul supplémentaire avec un filigrane d’évaluation.
Les limites sont indiquées ci-dessous :
- Nombre de fichiers ouverts (Aspose.Cells) Lors de l’exécution de votre programme, vous ne pouvez ouvrir que 100 fichiers Excel à l’aide de la bibliothèque Aspose.Cells. Si votre application dépasse ce nombre, une exception sera levée.
- Paramètres du fichier de configuration (Aspose.Cells.GridWeb) Vous ne pouvez pas re-spécifier le chemin du script en ajoutant les lignes de code suivantes dans la section de configuration (par exemple dans le fichier web.config). Le acw_client est un dossier qui contient des fichiers et Aspose.Cells. GridWeb utilise ce dossier pour gérer sa configuration interne, il contient des fichiers de script, des fichiers image et d’autres fichiers pour spécifier le comportement de GridWeb et définir d’autres opérations. Le fichier de configuration est utilisé pour empêcher le contrôle d’utiliser les ressources clientes embarquées (images, scripts, etc.) ce qui est utile dans certains cas/scénarios. De plus, ces paramètres de configuration dans le fichier web.config ne prendront effet qu’avec la version LICENSED du contrôle.
XML
<appSettings>
<add key="aspose.cells.gridweb.acw_client_path" value="/acw_client/" />
<add key="aspose.cells.gridweb.force_script_path" value="true" />
</appSettings>
De plus, une feuille de calcul avec un filigrane d’évaluation s’affichera toujours comme feuille de calcul active dans le fichier Excel généré à l’aide de la bibliothèque Aspose.Cells. Uniquement dans la version sous licence, vous pouvez définir la feuille de calcul active sur d’autres feuilles de calcul. Dans la sortie PDF ou le fichier image par Aspose.Cells, un filigrane d’évaluation serait collé en haut du document/image. Vous ne pouvez pas masquer l’avertissement de droit d’auteur d’évaluation (la feuille de calcul supplémentaire) dans le contrôle GridWeb également, il sera toujours ajouté (à la fin dans les onglets de la feuille de calcul) dans le champ.
Application d’une licence dans le composant Aspose.Cells
La licence est un fichier XML en texte brut qui contient des détails tels que le nom du produit, le nombre de développeurs auxquels il est licencié, la date d’expiration de l’abonnement, etc. Le fichier est signé numériquement, ne modifiez donc pas le fichier. Même l’ajout par inadvertance d’un saut de ligne supplémentaire dans le fichier l’invalidera. Vous devez définir une licence avant d’utiliser Aspose.Cells si vous souhaitez éviter sa limitation d’évaluation. Il n’est nécessaire de définir une licence qu’une seule fois par application (ou processus). La licence peut être chargée à partir d’un fichier, d’un flux ou d’une ressource intégrée.
Aspose.Cells tente de trouver la licence aux emplacements suivants :
- Chemin explicite
- Le dossier qui contient Aspose.Cells.dll
- Le dossier qui contient l’assembly appelé Aspose.Cells.dll
- Le dossier qui contient l’assembly d’entrée (votre .exe)
- Une ressource intégrée dans l’assembly qui a appelé Aspose.Cells.dll
Il existe deux méthodes courantes pour appliquer une licence, à partir d’un fichier ou d’un flux, ou en tant que ressource intégrée.
Application d’une licence à partir d’un disque ou d’un flux
Le moyen le plus simple de définir une licence consiste à placer le fichier de licence dans le même dossier que celui de Aspose.Cells.dll et à spécifier uniquement le nom du fichier sans son chemin.
//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");
Il est également possible de charger une licence à partir d’un flux.
//Instantiate an instance of license and set the license through a stream
Aspose.Cells.License license = new Aspose.Cells.License();
license.SetLicense(myStream);
Application d’une licence limitée
Aspose.Cells permet aux développeurs d’appliquer une clé mesurée. Il s’agit d’un nouveau mécanisme d’octroi de licences. Le nouveau mécanisme d’octroi de licences sera utilisé parallèlement à la méthode d’octroi de licences existante. Les clients qui souhaitent être facturés en fonction de l’utilisation des fonctionnalités API peuvent utiliser la licence mesurée. Pour plus de détails, veuillez consulterFAQ sur les licences limitéessection.
Une nouvelle classeCompteura été introduit pour appliquer la clé mesurée. Voici l’exemple de code montrant comment définir une clé publique et privée mesurée.
//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);
Utilisation d’une ressource intégrée
Une autre façon astucieuse d’emballer la licence avec votre application et de vous assurer qu’elle ne sera pas perdue consiste à l’inclure en tant que ressource intégrée dans l’un des assemblys qui appelle Aspose.Cells. Pour inclure le fichier de licence en tant que ressource intégrée, procédez comme suit :
- Dans Visual Studio .NET, incluez le fichier de licence (.lic) dans le projet en le sélectionnantAjouter un élément existant duDossier menu.
- Sélectionnez le fichier dans l’explorateur de solutions et définissezCréer une action àRessource intégrée dans la fenêtre Propriétés
Pour accéder à la licence intégrée dans l’assembly (en tant que ressource intégrée), il n’est pas nécessaire d’appeler les méthodes GetExecutingAssembly et GetManifestResourceStream de la classe System.Reflection.Assembly de Microsoft .NET Framework. Il suffit d’ajouter le fichier de licence en tant que ressource intégrée à votre projet et de transmettre le nom du fichier de licence dans la méthode SetLicense. LeAspose.Cells.License class trouvera automatiquement le fichier de licence dans les ressources intégrées. Veuillez consulter l’exemple ci-dessous pour comprendre cette méthode de configuration de la licence (intégrée) dans vos applications.
//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");
Configuration de la licence dans Aspose.Cells Grid Controls
Dans Aspose.Cells Grid Suite, la licence peut être chargée à partir d’un fichier, d’un flux ou d’une ressource intégrée. Aspose.Cells.GridDesktop / Aspose.Cells.GridWeb tente de trouver la licence aux emplacements suivants :
- Chemin explicite
- Le dossier qui contient la dll du composant (inclus dans Aspose.Cells.GridDesktop ou Aspose.Cells.GridWeb)
- Le dossier qui contient l’assembly qui a appelé la dll du composant (inclus dans Aspose.Cells.GridDesktop ou Aspose.Cells.GridWeb)
- Le dossier qui contient l’assembly d’entrée (votre .exe)
- Une ressource intégrée dans l’assembly qui a appelé la DLL du composant (incluse dans Aspose.Cells.GridDesktop ou Aspose.Cells.GridWeb)
Application d’une licence à partir d’un disque ou d’un flux
Le moyen le plus simple de définir une licence est de placer le fichier de licence dans le même dossier que celui de la dll du composant (inclus dans Aspose.Cells.GridWeb) et de spécifier uniquement le nom du fichier sans son chemin.
//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");
Il est également possible de charger une licence à partir d’un flux.
//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);
Application d’une licence en tant que ressource intégrée
Une autre façon astucieuse d’emballer la licence avec votre application et de vous assurer qu’elle ne sera pas perdue consiste à l’inclure en tant que ressource intégrée dans l’un des assemblages qui appellent la dll du composant (inclus dans Aspose.Cells.GridDesktop). Pour inclure le fichier de licence en tant que ressource intégrée, procédez comme suit :
- Dans Visual Studio .NET, incluez le fichier de licence (.lic) dans le projet en utilisant leAjouter un élément existant possibilité sur leDossier menu.
- Sélectionnez le fichier dans l’explorateur de solutions et définissez Build Action sur Embedded Resource dans la fenêtre Propriétés.
- Pour accéder à la licence intégrée dans l’assembly (en tant que ressource intégrée), il n’est pas nécessaire d’appeler les méthodes GetExecutingAssembly et GetManifestResourceStream de la classe System.Reflection.Assembly de Microsoft .NET Framework.A la place, ajoutez le fichier de licence en tant que ressource intégrée dans votre projet et transmettez le nom du fichier de licence dans la méthode SetLicense. La classe Licence trouve automatiquement le fichier de licence dans les ressources intégrées.
Veuillez consulter l’exemple ci-dessous pour comprendre cette méthode d’application d’une licence en tant que ressource intégrée à vos applications.
//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");
Application d’une licence dans Aspose.Cells.GridDesktop pour une application WinForm
Il est recommandé de mettre votre code de licence avant le démarrage de votre application et de ne l’appliquer qu’une seule fois. Par exemple, pour une application Windows C#, placez le code de licence dans la méthode 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;
}
}
Remarques sur l’application d’une licence dans Aspose.Cells.GridWeb
Il est recommandé de mettre le code de licence dans le Global.asax.cs de votre application web (ce fichier de licence est supposé être placé sur le lecteur " 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");
}
Chargement d’une licence à partir d’un flux
protected void Application_Start(Object sender, EventArgs e)
{
Aspose.Cells.GridWeb.License lic = new Aspose.Cells.GridWeb.License();
lic.SetLicense(myStream);
}