Public API Changements dans Aspose.Cells 8.3.2

Ce document décrit les modifications apportées au Aspose.Cells API de la version 8.3.1 à 8.3.2 qui peuvent intéresser les développeurs de modules/applications. Il comprend non seulement des méthodes publiques nouvelles et mises à jour,classes ajoutées, etc. etclasses supprimées, etc., mais aussi une description de tout changement de comportement dans les coulisses du Aspose.Cells.

API ajoutées

Mécanisme pour définir la position absolue de PivotItem

Afin de fournir la fonctionnalitéPositionnement absolu de PivotItemle Aspose.Cells for .NET 8.3.2 a exposé une série de propriétés et de méthodes d’aide répertoriées ci-dessous.

La propriété PivotItem.Position peut être utilisée pour spécifier l’index de position dans tous les PivotItems, quel que soit le nœud parent.
La propriété PivotItem.PositionInSameParentNode peut être utilisée pour spécifier l’index de position dans les PivotItems sous le même nœud parent.
La méthode PivotItem.Move(int count, bool isSameParent) peut être utilisée pour déplacer l’élément vers le haut ou vers le bas en fonction de la valeur de comptage, où count est le nombre de positions pour déplacer le PivotItem vers le haut ou vers le bas. Si la valeur de comptage est inférieure à zéro, l’élément sera déplacé vers le haut où, comme si la valeur de comptage est supérieure à zéro, le PivotItem se déplacera vers le bas, le paramètre de type booléen isSameParent spécifie si l’opération de déplacement doit être effectuée dans le même nœud parent ou non.

Veuillez noter qu’il est nécessaire d’appeler les méthodes PivotTable.RefreshData et PivotTable.CalculateData avant d’utiliser les propriétés PivotItem.Position, PivotItem.PositionInSameParentNode et la méthode PivotItem.Move(int count, bool isSameParent).

Ligne de signature de classe ajoutée

Aspose.Cells for .NET 8.3.2 fournit la prise en charge de la ligne de signature pour imiter la fonctionnalité équivalente de MS Excel. Cette version de Aspose.Cells for .NET a exposé la classe SignatureLine et la propriété Picture.SignatureLine à cette fin.

L’exemple de code suivant ajoute une ligne de signature à l’aide de la propriété Picture.SignatureLine au classeur.

 //Create workbook object

Workbook workbook = new Workbook();

//Insert picture of your choice

int index = workbook.Worksheets[0].Pictures.Add(0, 0, "signature.jpg");

//Access picture and add signature line inside it

Picture pic = workbook.Worksheets[0].Pictures[index];

//Create signature line object

SignatureLine s = new SignatureLine();

s.Signer = "John Doe";

s.Title = "Development Lead";

s.Email = "john.doe@aspose.com";

//Assign the signature line object to Picture.SignatureLine property

pic.SignatureLine = s;

Méthode Chart.HasAxis ajouté

Avec la version v8.3.2, le Aspose.Cells API a fourni la méthode Chart.HasAxis(AxisType axisType, bool isPrimary) pour déterminer si le graphique a un axe particulier ou non.

L’exemple de code suivant illustre l’utilisation de la méthode Chart.HasAxis pour déterminer si l’exemple de graphique a un axe principal, secondaire et de valeur.

 //Create workbook object

Workbook workbook = new Workbook("source.xlsx");

//Access the first worksheet

Worksheet worksheet = workbook.Worksheets[0];

//Access the chart

Chart chart = worksheet.Charts[0];

//Determine which axis exists in chart

bool ret = chart.HasAxis(AxisType.Category, true);

Console.WriteLine("Has Primary Category Axis: " + ret);

ret = chart.HasAxis(AxisType.Category, false);

Console.WriteLine("Has Secondary Category Axis: " + ret);

ret = chart.HasAxis(AxisType.Value, true);

Console.WriteLine("Has Primary Value Axis: " + ret);

ret = chart.HasAxis(AxisType.Value, false);

Console.WriteLine("Has Secondary Value Axis: " + ret);

Méthode WorkbookSettings.CheckWriteProtectedPassword ajouté

La méthode WorkbookSettings.CheckWriteProtectedPassword permet aux développeurs de vérifier si un mot de passe donné pour modifier la feuille de calcul est correct ou non.

 //Specify password to open inside the load options

LoadOptions opts = new LoadOptions();

opts.Password = "1234";

//Open the source Excel file with load options

Workbook workbook = new Workbook("Book1.xlsx", opts);

//Check if 567 is Password to modify

bool ret = workbook.CheckWriteProtectedPassword("567");

Console.WriteLine("Is 567 correct Password to modify: " + ret);

Méthodes de surcharge WorkbookRender.ToPrinter & SheetRender.ToPrinter ajoutés

Aspose.Cells for .NET 8.3.2 a fourni les méthodes WorkbookRender.ToPrinter(string PrinterName, int PrintPageIndex, int PrintPageCount) et SheetRender.ToPrinter(string PrinterName, int PrintPageIndex, int PrintPageCount) pour imprimer respectivement la plage de pages du classeur et de la feuille de calcul.

L’exemple de code suivant illustre l’utilisation des méthodes susmentionnées pour imprimer les pages 2 à 5 du classeur et de la feuille de calcul.

 //Create workbook from source Excel file

Workbook workbook = new Workbook("source.xlsx");

//Print the workbook specifying the range of pages

//Here we are printing pages 2-5

WorkbookRender wr = new WorkbookRender(workbook, new ImageOrPrintOptions());

wr.ToPrinter(printerName, 1, 4);

//Access first worksheet

Worksheet worksheet = workbook.Worksheets[0];

//Print the worksheet specifying the range of pages

//Here we are printing pages 2-5

SheetRender sr = new SheetRender(worksheet, new ImageOrPrintOptions());

sr.ToPrinter(printerName, 1, 4);

Méthode Worksheet.RefreshPivotTables ajoutée

La méthode nouvellement ajoutée Worksheet.RefreshPivotTables permet d’actualiser tous les tableaux croisés dynamiques d’une feuille de calcul donnée en un seul appel.

 worksheet.RefreshPivotTables();

Méthode Workbook.GetNamedStyle ajouté

Aspose.Cells for .NET API a exposé la méthode Workbook.GetNamedStyle qui accepte la chaîne comme paramètre et récupère l’objet Style en fonction du paramètre passé.

Méthode Cells.ImportTwoDimensionArray ajoutée

Aspose.Cells for .NET API a rendu possible l’importation de tableaux bidimensionnels dans des cellules de feuille de calcul en exposant la méthode Cells.ImportTwoDimensionArray(object[,], object[,], int, int, TxtLoadOptions). Ladite méthode importe un tableau de données à deux dimensions dans une feuille de calcul avec des options plus flexibles définies dans TxtLoadOptions.

Propriétés OnePagePerSheet, PageIndex et PageCount ajoutées

Aspose.Cells for .NET 8.3.2 a exposé les propriétés OnePagePerSheet, PageIndex et PageCount pour la classe XpsSaveOptions. L’utilisateur peut faire tenir tout le contenu d’une feuille de calcul sur une seule page de XPS à l’aide de la propriété OnePagePerSheet et/ou récupérer le nombre de pages à imprimer à l’aide de la propriété PageCount. La propriété PageIndex obtient/définit l’index de base 0 de la première page à enregistrer.

Propriétés NumberDecimalSeparator & NumberGroupSeparator ajoutées

Aspose.Cells for .NET 8.3.2 a introduit les propriétés NumberDecimalSeparator et NumberGroupSeparator qui peuvent obtenir/définir les séparateurs personnalisés utilisés pour formater et analyser les valeurs numériques dans les feuilles de calcul.

L’exemple de code suivant illustre comment spécifier les séparateurs personnalisés à l’aide de Aspose.Cells API. Le code suivant spécifie les séparateurs décimaux et de groupe personnalisés comme point et espace respectivement.

 Workbook workbook = new Workbook();

//Specify custom separators

workbook.Settings.NumberDecimalSeparator = '.';

workbook.Settings.NumberGroupSeparator = ' ';

Propriété PdfSaveOptions.IsFontSubstitutionCharGranularity ajoutée

Aspose.Cells for .NET 8.3.2 a exposé la propriété PdfSaveOptions.IsFontSubstitutionCharGranularity afin de résoudre le problème où certains caractères Unicode ne peuvent pas être affichés à l’aide d’une famille de polices spécifique. Lorsque la propriété PdfSaveOptions.IsFontSubstitutionCharGranularity est définie sur true, seule la police d’un caractère spécifique qui n’est pas affichable sera remplacée par une police affichable et le reste du mot ou de la phrase doit rester dans la police d’origine.

 //Save to Pdf after setting PdfSaveOptions.IsFontSubstitutionCharGranularity to true

PdfSaveOptions opts = new PdfSaveOptions();

opts.IsFontSubstitutionCharGranularity = true;

API supprimées

Méthodes obsolètes supprimées

Les méthodes suivantes ont été supprimées du Public API.

Méthodes Workbook.Open & Workbook.Save.
Méthode Workbook.SetOleSize.
Méthode Workbook.LoadData.
Méthodes WorkbookDesigner.Open et WorkbookDesigner.Save.
Méthode WorksheetCollection.DeleteName.

Propriétés obsolètes supprimées

Les propriétés suivantes ont été retirées du public API.

Propriété Workbook.IsProtected.
Propriété Workbook.Language.
Propriété Workbook.Region.
Propriété WorkbookSettings.ReCalcOnOpen.
Propriété WorkbookSettings.Language.
Propriété WorkbookSettings.Encoding.
Propriété WorkbookSettings.ConvertNumericData.
Propriété WorksheetCollection.HidePivotFieldList.
Propriété WorksheetCollection.EnableHTTPCompression.
Propriété WorksheetCollection.IsMinimized.
Propriété WorksheetCollection.IsHidden.
Propriété WorksheetCollection.SheetTabBarWidth.
Propriété WorksheetCollection.WindowLeft.
Propriété WorksheetCollection.WindowLeftInch.
Propriété WorksheetCollection.WindowLeftCM.
Propriété WorksheetCollection.WindowTop.
Propriété WorksheetCollection.WindowTopInch.
Propriété WorksheetCollection.WindowTopCM.
Propriété WorksheetCollection.WindowWidth.
Propriété WorksheetCollection.WindowWidthInch.
Propriété WorksheetCollection.WindowWidthCM.
Propriété WorksheetCollection.WindowHeight.
Propriété WorksheetCollection.WindowHeightInch.
Propriété WorksheetCollection.WindowHeightCM.
Propriété Worksheet.HPageBreaks.
Propriété Worksheet.VPageBreaks.
Propriété HtmlSaveOptions.DisplayHTMLCrossString.
Propriété HtmlSaveOptions.ExportChartImageFormat.
Propriété SaveOptions.ExpCellNameToXLSX.
Propriété SaveOptions.DefaultFont.
Propriété SaveOptions.Compliance.
Propriété SaveOptions.PdfBookmark.
Propriété SaveOptions.PdfImageCompression.
Propriété TxtSaveOptions.AlwaysQuoted.

API obsolètes

Property Workbook.SaveOptions Obsolète

Un objet de SaveOptions doit être passé à la méthode Workbook.Save après avoir défini les propriétés SaveOptions appropriées.

Property Workbook.Styles & Class StyleCollection Obsolète

Il est conseillé d’utiliser la méthode Workbook.CreateStyle pour créer et manipuler le style de l’instance Workbook au lieu de créer un style avec la méthode StyleCollection.Add. De plus, la méthode Workbook.GetNamedStyle(string) peut être utilisée pour obtenir un style nommé au lieu de StyleCollection[string].

Méthode PivotItem.Move(int count) Obsolète

Avec la version Aspose.Cells 8.3.2, le API a introduit une autre surcharge de la méthode PivotItem.Move qui accepte le paramètre entier pour le nombre et le paramètre booléen pour déplacer un PivotItem dans le nœud parent.

Public API Changements dans Aspose.Cells 8.3.1 Public API Changements dans Aspose.Cells 8.4.0