Public API Changements dans Aspose.Cells 16.11.0
API ajoutées
Prise en charge des paramètres de globalisation
Aspose.Cells 16.11.0 a exposé la classe GlobalizationSettings avec la propriété WorkbookSettings.GlobalizationSettings afin de forcer les API Aspose.Cells à utiliser des étiquettes personnalisées pour les sous-totaux. La classe GlobalizationSettings a les méthodes suivantes qui peuvent être remplacées dans l’implémentation personnalisée pour donner les noms souhaités aux étiquettesTotal & Total.
- GlobalizationSettings.GetTotalName : obtient le nom total de la fonction.
- GlobalizationSettings.GetGrandTotalName : obtient le nom du total général de la fonction.
Voici une classe personnalisée simple qui étend la classe GlobalizationSettings et remplace ses méthodes susmentionnées pour renvoyer des étiquettes personnalisées pour la fonction de consolidation Moyenne.
C#
class CustomSettings : GlobalizationSettings
{
public override string GetTotalName(ConsolidationFunction functionType)
{
switch (functionType)
{
case ConsolidationFunction.Average:
return "AVG";
default:
return base.GetTotalName(functionType);
}
}
public override string GetGrandTotalName(ConsolidationFunction functionType)
{
switch (functionType)
{
case ConsolidationFunction.Average:
return "GRD AVG";
default:
return base.GetGrandTotalName(functionType);
}
}
}
L’extrait de code suivant charge une feuille de calcul existante et ajoute le sous-total de type Moyenne aux données déjà disponibles dans la feuille de calcul. La classe CustomSettings et ses méthodes GetTotalName & GetGrandTotalName seront appelées au moment de l’ajout de Subtotal à la feuille de calcul.
C#
// Loads an existing spreadsheet containing some data
Workbook book = new Workbook(dir + "sample.xlsx");
// Assigns the GlobalizationSettings property of the WorkbookSettings class
// to the class created in first step
book.Settings.GlobalizationSettings = new Cells.CustomSettings();
// Accesses the 1st worksheet from the collection which contains data
// Data resides in the cell range A2:B9
Worksheet sheet = book.Worksheets[0];
// Adds SubTotal of type Average to the worksheet
sheet.Cells.Subtotal(CellArea.CreateCellArea("A2", "B9"), 0, ConsolidationFunction.Average, new int[]{ 0,1 });
// Calculates Formulas
book.CalculateFormula();
// Auto fits all columns
sheet.AutoFitColumns();
// Saves the workbook on disc
book.Save(dir + "output.xlsx");
La classe GlobalizationSettings propose également la méthode GetOtherName qui est utile pour obtenir le nom des étiquettes “Autre” pour les camemberts. Voici un scénario d’utilisation simple de la méthode GlobalizationSettings.GetOtherName.
C#
class CustomSettings : GlobalizationSettings
{
public override string GetOtherName()
{
int lcid = System.Globalization.CultureInfo.CurrentCulture.LCID;
switch (lcid)
{
case 1033:
return "Other";
case 1036:
return "Autre";
case 1031:
return "Andere";
//Do other case
default:
return base.GetOtherName();
}
}
}
L’extrait de code suivant charge une feuille de calcul existante contenant un graphique à secteurs et affiche le graphique en image tout en utilisant la classe CustomSettings créée ci-dessus.
C#
// Loads an existing spreadsheet containing a pie chart
Workbook book = new Workbook(dir + "sample.xlsx");
// Assigns the GlobalizationSettings property of the WorkbookSettings class
// to the class created in first step
book.Settings.GlobalizationSettings = new Cells.CustomSettings();
// Accesses the 1st worksheet from the collection which contains pie chart
Worksheet sheet = book.Worksheets[0];
// Accesses the 1st chart from the collection
Chart chart = sheet.Charts[0];
// Refreshes the chart
chart.Calculate();
// Renders the chart to image
chart.ToImage(dir + "output.png", new ImageOrPrintOptions());
Classe CellsFactory ajoutée
Aspose.Cells 16.11.0 a exposé la classe CellsFactory qui a actuellement une méthode, c’est-à-dire ; CréerStyle. La méthode CellsFactory.CreateStyle peut être utilisée pour créer une instance de la classe Style sans l’ajouter au pool de styles de classeur.
Voici un scénario d’utilisation simple de la méthode CellsFactory.CreateStyle.
C#
// Initializes the CellsFactory class
CellsFactory factory = new CellsFactory();
// Creates an instance of Style
Style style = factory.CreateStyle();
Ajout de la propriété Workbook.AbsolutePath
Aspose.Cells 16.11.0 a exposé la propriété Workbook.AbsolutePath permettant d’obtenir ou de définir le chemin absolu du classeur stocké dans le fichier workbook.xml. Cette propriété est utile lors de la mise à jour des liens externes uniquement.
Ajout de la méthode GridHyperlinkCollection.GetHyperlink
Aspose.Cells.GridWeb 16.11.0 a exposé la méthode GetHyperlink à la classe GridHyperlinkCollection qui permet d’obtenir l’instance de GridHyperlink en passant une instance GridCell ou une paire d’entiers correspondant aux indices de colonne de ligne.
Voici un scénario d’utilisation simple de la méthode GetHyperlink.
C#
// Gets the active worksheet from the collection
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];
// Accesses the GridHyperlinkCollection
GridHyperlinkCollection links = sheet.Hyperlinks;
// Gets hyperlink from cell A1
GridHyperlink link = links.GetHyperlink(sheet.Cells["A1"]);
// Gets hyperlink from cell D1
link = links.GetHyperlink(0, 3);
API obsolètes
Constructeur de style obsolète
Veuillez utiliser la méthode cellsFactory.CreateStyle comme alternative.
API supprimées
Méthode Cell.GetConditionalStyle supprimée
Veuillez utiliser la méthode Cell.GetConditionalFormattingResult à la place.
Méthode Cells.MaxDataRowInColumn(int column) supprimée
Veuillez utiliser la méthode Cells.GetLastDataRow(int) comme alternative.
Propriété PageSetup.Draft supprimée
Il est conseillé d’utiliser à la place la propriété PageSetup.PrintDraft.
Propriété AutoFilter.FilterColumnCollection supprimée
Veuillez envisager d’utiliser la propriété AutoFilter.FilterColumns pour atteindre le même objectif.
Propriété TickLabels.Rotation supprimée
Veuillez utiliser la propriété TickLabels.RotationAngle à la place.