Changements apportés à l API publique dans Aspose.Cells 8.8.1
APIs ajoutées
Filtrer les données à charger
Aspose.Cells for .NET 8.8.1 a exposé l’énumération LoadDataFilterOptions ainsi que la propriété LoadOptions.LoadDataFilterOptions qui peut être utilisée pour spécifier le type de données qui doit être chargé lors de la construction du classeur à partir d’un fichier de modèle. Le filtrage des données chargées peut améliorer les performances à des fins spéciales, en particulier lors de l’utilisation des API LightCells.
L’énumération LoadDataFilterOptions propose les sélections suivantes.
- Tous pour charger tout depuis la feuille de calcul.
- Aucun pour ne rien charger depuis la feuille de calcul.
- CellBlank charge les cellules dont les valeurs sont vides.
- CellBool charge les cellules dont les valeurs sont booléennes.
- CellData charge les données des cellules, y compris les valeurs, les formules et la mise en forme.
- CellError charge les cellules dont les valeurs sont des erreurs.
- CellNumeric charge les cellules dont les valeurs sont numériques (y compris Date & Heure).
- CellString charge les cellules dont les valeurs sont du texte/chaîne de caractères.
- CellValue charge uniquement les valeurs des cellules (tous les types).
- Le graphique charge uniquement les diagrammes.
- ConditionalFormatting charge uniquement les règles de mise en forme conditionnelle.
- DataValidation charge uniquement les règles de validation des données.
- DocumentProperties charge uniquement les propriétés du document.
- Formule charge les formules y compris les noms définis.
- MergedArea charge uniquement les cellules fusionnées.
- PivotTable charge les tableaux croisés dynamiques.
- Paramètres charge uniquement les paramètres du classeur et de la feuille de calcul.
- Forme charge uniquement les formes.
- Style charge la mise en forme des cellules.
- Table charge les tables Excel/List Objects.
Voici le scénario d’utilisation simple.
C#
//Create an instance of LoadOptions & initialize it with type of template to be loaded
var options = new LoadOptions(LoadFormat.Xlsx);
//Set LoadDataFilterOptions to load only shapes
options.LoadDataFilterOptions = LoadDataFilterOptions.Shape;
//Create an instance of Workbook from a existing spreadsheet using instance of LoadOptions
var book = new Workbook(filePath, options);
Convertir directement le graphique en PDF
Les API Aspose.Cells ont déjà fourni la possibilité de rendre les graphiques en PDF en utilisant la méthode Chart.ToPdf. Avec cette version, l’API a exposé une autre version surchargée de ladite méthode qui pourrait accepter une instance de Stream, permettant aux utilisateurs de sauvegarder le PDF du graphique dans une instance de MemoryStream.
Voici le scénario d’utilisation simple.
C#
//Create an instance of Workbook and load an existing spreadsheet with a chart
var workbook = new Workbook(filePath);
//Access first worksheet containing a chart
var worksheet = workbook.Worksheets[0];
//Access first chart from the worksheet
var chart = worksheet.Charts[0];
//Save the chart to PDF as Stream
using (MemoryStream stream = new MemoryStream())
{
chart.ToPdf(stream);
}
Ajout de la propriété WorkbookSettings.PaperSize
Aspose.Cells for .NET 8.8.1 a exposé la propriété WorkbookSettings.PaperSize afin de définir la taille de papier d’impression par défaut pour toute la feuille de calcul. La propriété WorkbookSettings.PaperSize accepte une valeur de l’énumération PaperSizeType qui contient les tailles prédéfinies pour les types de papier les plus largement utilisés.
C#
//Create an instance of Workbook
//Optionally load an existing spreadsheet
var book = new Workbook();
//Access WorkbookSettings from the Workbook
var settings = book.Settings;
//Set the default printing paper size for the Workbook
settings.PaperSize = PaperSizeType.PaperA4;
Propriété Shape.TextBody ajoutée
Cette version de l’API Aspose.Cells for .NET a exposé la propriété Shape.TextBody afin de manipuler les aspects du texte dans une forme. L’extrait suivant utilise ladite propriété pour définir l’effet d’ombre du texte dans un TextBox.
C#
//Create an instance of Workbook
var book = new Workbook();
//Access first worksheet of the Workbook
var sheet = book.Worksheets[0];
//Add a TextBox to the ShapeCollection
var textBox = sheet.Shapes.AddTextBox(2, 0, 2, 0, 100, 400);
//Set the text of the TextBox
textBox.Text = "This text has the following settings.\n\nText Effects > Shadow > Offset Bottom";
//Set shadow effect for text
for (int i = 0; i < textBox.TextBody.Count; i++)
{
textBox.TextBody[i].ShapeFont.FillFormat.ShadowEffect.PresetType = PresetShadowType.OffsetBottom;
}
Méthode ajoutée Worksheet.CalculateFormula(string formule, OptionsCalcul opts)
Aspose.Cells for .NET 8.8.1 a exposé une autre surcharge pour la méthode CalculateFormula qui offre la capacité de calculer une formule donnée directement avec des options personnalisées.
Méthode ajoutée GridCell.CreateValidation
Aspose.Cells.GridWeb a fourni la possibilité d’ajouter directement la règle de validation à une seule cellule en utilisant la méthode GridCell.CreateValidation. Ladite méthode nécessite 2 paramètres. Le premier est de type GridValidationType qui détermine le type de validation, tandis que le deuxième paramètre (isRequied) est de type Boolean.
C#
//Access first worksheet
GridWorksheet sheet = GridWeb1.WorkSheets[0];
//Access cell B3
GridCell cell = sheet.Cells["B3"];
//Add validation inside the GridCell
//Any value which is not between 20 and 40 will cause error in a GridCell
GridValidation val = cell.CreateValidation(GridValidationType.WholeNumber, true);
val.Formula1 = "=20";
val.Formula2 = "=40";
val.Operator = GridOperatorType.Between;
val.ShowError = true;
val.ShowInput = true;
Méthode ajoutée GridCell.RemoveValidation
Aspose.Cells.GridWeb a également fourni la possibilité de supprimer la règle de validation des données d’une GridCell en utilisant la méthode GridCell.RemoveValidation.
APIs obsolètes
Propriété Shape.TextFrame rendue obsolète
Il est conseillé d’utiliser la propriété Shape.TextBody.TextAlignment à la place.