Public API Changements dans Aspose.Cells 8.4.2
API ajoutées
Mécanisme de création de graphiques amélioré
La classe Aspose.Cells.Charts.Chart a exposé la méthode SetChartDataRange pour faciliter la tâche de création de graphique. La méthode SetChartDataRange accepte deux paramètres, où le premier paramètre est de type chaîne qui spécifie la zone de cellule à partir de laquelle tracer la série de données. Le deuxième paramètre est de type booléen qui spécifie l’orientation du tracé, c’est-à-dire ; s’il faut tracer la série de données du graphique à partir d’une plage de valeurs de cellule par ligne ou par colonnes.
L’extrait de code suivant montre comment créer un histogramme avec quelques lignes de code en supposant que les données de la série de tracés 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);
Méthode VbaModuleCollection.Add Ajouté
Aspose.Cells for .NET 8.4.2 a exposé la méthode VbaModuleCollection.Add pour ajouter un nouveau module VBA à l’instance de Workbook. La méthode VbaModuleCollection.Add accepte un paramètre de type Worksheet pour ajouter un module spécifique à une feuille de calcul.
L’extrait de 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 méthode nouvellement exposée accepte 5 paramètres au total, où les 4 premiers paramètres sont identiques à 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.
L’extrait de code suivant montre comment utiliser la méthode Cells.CopyColumns nouvellement exposée.
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 version v8.4.2, le Aspose.Cells API a ajouté 2 nouveaux champs d’énumération pour PasteType comme détaillé ci-dessous.
- PasteType.Default : Fonctionne de la même manière que la fonctionnalité “Tous” 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.
L’exemple de code suivant illustre 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);