Licence

Comment appliquer 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 autorisé, la date d’expiration de l’abonnement, etc. Le fichier est signé numériquement, donc ne le modifiez pas. Même l’ajout accidentel 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 voulez éviter sa limitation d’évaluation. Il est seulement nécessaire de définir une licence une 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 essaie de trouver la licence aux emplacements suivants:

  • Chemin explicite
  • Le dossier contenant Aspose.Cells.dll
  • Le dossier contenant l’assembly qui a appelé Aspose.Cells.dll
  • Le dossier contenant 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.

Comment appliquer une licence à partir d’un disque ou d’un flux

La manière la plus simple de définir une licence est de placer le fichier de licence dans le même dossier que celui d’Aspose.Cells.dll 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.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);

Comment appliquer une licence mesurée

Aspose.Cells permet aux développeurs d’appliquer une clé mesurée. Il s’agit d’un nouveau mécanisme de licence. Le nouveau mécanisme de licence sera utilisé avec la méthode de licence existante. Les clients qui veulent être facturés en fonction de l’utilisation des fonctionnalités de l’API peuvent utiliser la licence mesurée. Pour plus de détails, veuillez vous référer à la section FAQ sur la Licence Mesurée.  

Une nouvelle classe Metered a été introduite pour appliquer une clé mesurée. Voici un exemple de code dé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);

Comment utiliser une ressource intégrée

Une autre manière pratique d’emballer la licence avec votre application et de vous assurer qu’elle ne sera pas perdue, est de l’inclure en tant que ressource intégrée dans l’un des assemblies qui appelle Aspose.Cells. Pour inclure le fichier de licence en tant que ressource intégrée, effectuez les étapes suivantes:

  1. Dans Visual Studio .NET, incluez le fichier de licence (.lic) dans le projet en sélectionnant Ajouter un élément existant dans le menu Fichier.
  2. Sélectionnez le fichier dans l’Explorateur de solutions et définissez Action de build sur 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 à la méthode SetLicense. La classe Aspose.Cells.License trouvera automatiquement le fichier de licence dans les ressources intégrées. Veuillez consulter l’exemple ci-dessous pour comprendre cette méthode de définition de 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");

Comment définir la licence dans les contrôles de grille Aspose.Cells

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 :

  1. Chemin explicite
  2. Le dossier qui contient le fichier DLL du composant (inclus dans Aspose.Cells.GridDesktop ou Aspose.Cells.GridWeb)
  3. Le dossier qui contient l’assembly qui a appelé le fichier DLL du composant (inclus dans Aspose.Cells.GridDesktop ou Aspose.Cells.GridWeb)
  4. Le dossier qui contient l’assembly d’entrée (votre .exe)
  5. Une ressource intégrée dans l’assembly qui a appelé le fichier DLL du composant (inclus dans Aspose.Cells.GridDesktop ou Aspose.Cells.GridWeb)

Comment appliquer une licence à partir d’un disque ou d’un flux

La manière la plus simple de définir une licence est de placer le fichier de licence dans le même dossier que celui du fichier 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);

Comment appliquer une licence en tant que ressource intégrée

Une autre façon de conditionner la licence avec votre application et de vous assurer qu’elle ne sera pas perdue est de l’inclure en tant que ressource intégrée dans l’un des assemblies qui appelle le fichier DLL du composant (inclus dans Aspose.Cells.GridDesktop). Pour inclure le fichier de licence en tant que ressource intégrée, suivez les étapes suivantes :

  1. Dans Visual Studio .NET, inclure le fichier de licence (.lic) dans le projet en utilisant l’option Ajouter un élément existant dans le menu Fichier.
  2. Sélectionnez le fichier dans l’Explorateur de solutions et définissez l’Action de génération sur Ressource intégrée dans la fenêtre Propriétés.
  3. 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 du framework Microsoft .NET. Au lieu de cela, ajoutez le fichier de licence en tant que ressource intégrée dans votre projet et transmettez le nom du fichier de licence à la méthode SetLicense. La classe License 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");

Comment appliquer une licence dans Aspose.Cells.GridDesktop pour une application WinForm

Il est recommandé de placer votre code de licence avant le démarrage de votre application et de l’appliquer une seule fois. Par exemple, pour une application C# Windows, 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;

}

}

Notes on Applying a License in 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 censé ê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);

}
Limitations de la version d évaluation Témoignages de réussite