Changements d API publics dans Aspose.Cells 8.4.2
APIs ajoutées
Mécanisme de création de graphique amélioré
La classe Aspose.Cells.Charts.Chart a exposé la méthode SetChartDataRange pour faciliter la tâche de création de graphiques. La méthode SetChartDataRange accepte deux paramètres, le premier paramètre étant de type chaîne spécifiant la plage de cellules à partir de laquelle tracer les séries de données. Le deuxième paramètre est de type Boolean spécifiant l’orientation du tracé, c’est-à-dire s’il faut tracer les séries de données du graphique à partir d’une plage de valeurs de cellules par ligne ou par colonnes.
Le snippet de code suivant montre comment créer un graphique à colonnes avec quelques lignes de code en supposant que les données de séries de tracé du graphique sont présentes sur la même feuille de calcul de la cellule A1 à D4.
C#
//Add a new chart of type Column to chart collection
int idx = worksheet.Charts.Add(ChartType.Column, 6, 5, 20, 13);
//Retrieve the newly added chart instance
Chart chart = worksheet.Charts[idx];
//Specify the chart's data series from cell A1 to D4
chart.SetChartDataRange("A1:D4", true);
Ajout de la méthode VbaModuleCollection.Add
Aspose.Cells for .NET 8.4.2 a exposé la méthode VbaModuleCollection.Add pour ajouter un nouveau module VBA à l’instance du classeur. La méthode VbaModuleCollection.Add accepte un paramètre de type Worksheet pour ajouter un module spécifique à la feuille de calcul.
Le code suivant montre comment utiliser la méthode VbaModuleCollection.Add.
C#
//Create new workbook
Workbook workbook = new Workbook();
//Access first worksheet
Worksheet worksheet = workbook.Worksheets[0];
//Add VBA module for first worksheet
int idx = workbook.VbaProject.Modules.Add(worksheet);
//Access the VBA Module, set its name and code
Aspose.Cells.Vba.VbaModule module = workbook.VbaProject.Modules[idx];
module.Name = "TestModule";
module.Codes = "Sub ShowMessage()" + "\r\n" +
" MsgBox \"Welcome to Aspose!\"" + "\r\n" +
"End Sub";
//Save the workbook
workbook.Save(output, SaveFormat.Xlsm);
Méthode surchargée Cells.CopyColumns ajoutée
Aspose.Cells for .NET 8.4.2 a exposé une version surchargée de la méthode Cells.CopyColumns pour répéter les colonnes source sur la destination. La nouvelle méthode exposée accepte un total de 5 paramètres, où les 4 premiers paramètres sont les mêmes que ceux de la méthode commune Cells.CopyColumns. Cependant, le dernier paramètre de type int spécifie le nombre de colonnes de destination sur lesquelles les colonnes source doivent être répétées.
Le code suivant montre comment utiliser la nouvelle méthode exposée Cells.CopyColumns.
C#
//Load an existing workbook
Workbook workbook = new Workbook(input);
//Access first worksheet
Worksheet worksheet = workbook.Worksheets[0];
//Access cells of first worksheet
Cells cells = worksheet.Cells;
//Copy the first two columns (A & B) along with formatting
//to columns G, H & I.
//Please note, the columns G & H will be replaced by A & B respectively
//whereas, column I will be replaced by the column A
cells.CopyColumns(cells, 0, 2, 6, 3);
//Save the workbook
workbook.Save(output);
Champs d’énumération PasteType.Default & PasteType.DefaultExceptBorders ajoutés
Avec la sortie de v8.4.2, l’API Aspose.Cells a ajouté 2 nouvelles énumérations pour PasteType comme détaillé ci-dessous.
- PasteType.Default : Fonctionne de manière similaire à la fonctionnalité “Tout” d’Excel pour coller une plage de cellules.
- PasteType.DefaultExceptBorders : Fonctionne de manière similaire à la fonctionnalité “Tout sauf les bordures” d’Excel pour coller une plage de cellules.
Le code d’exemple suivant démontre l’utilisation du champ PasteType.Default.
C#
//Load an existing workbook
Workbook workbook = new Workbook(input);
//Access first worksheet
Worksheet worksheet = workbook.Worksheets[0];
//Access cells of first worksheet
Cells cells = worksheet.Cells;
//Create source & destination ranges
Range source = cells.CreateRange("A1:B6");
Range destination = cells.CreateRange("D1:E6");
//Copy the source range onto the destination range with everything except column widths
destination.Copy(source, new PasteOptions() { PasteType = PasteType.Default });
//Save the workbook
workbook.Save(output);