Public API Changements dans Aspose.Cells 8.6.0

Ce document décrit les modifications apportées au Aspose.Cells API de la version 8.5.2 à 8.6.0 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., mais aussi une description de tout changement de comportement dans les coulisses du Aspose.Cells.

API ajoutées

Prise en charge de la manipulation des métadonnées sans créer d’objet de classeur

Cette version de Aspose.Cells for .NET API a exposé deux nouvelles classes, à savoir WorkbookMetadata & MetadataOptions, ainsi qu’une nouvelle énumération MetadataType qui permet désormais de manipuler les propriétés du document (métadonnées) sans créer d’instance de Workbook. La classe WorkbookMetadata est légère et fournit un mécanisme très facile à utiliser et efficace pourlire, écrire et mettre à jour les propriétés du document sans affecter les performances globales.

Voici le scénario d’utilisation simple.

 //Load a spreadsheet with WorkbookMetadata while specifying appropriate MetadataType

MetadataOptions options = new MetadataOptions(MetadataType.DocumentProperties);

WorkbookMetadata metadata = new WorkbookMetadata(filePath, options);

//Set some properties

metadata.CustomDocumentProperties.Add("test", "test");

//Save the metadata info to spreadsheet

metadata.Save(filePath);

Propriété HtmlSaveOptions.ExportFrameScriptsAndProperties ajoutée

Aspose.Cells for .NET 8.6.0 a exposé la propriété HtmlSaveOptions.ExportFrameScriptsAndProperties qui peut être utilisée pour influencer la création de scripts supplémentaires lors de la conversion des feuilles de calcul au format HTML. Avec les paramètres par défaut, les API Aspose.Cells exportent la feuille de calcul au format HTML lorsque l’application Excel effectue l’exportation, c’est-à-dire ; le HTML résultant contient les cadres et les commentaires conditionnels, qui détectent le type de navigateur et ajustent la mise en page en conséquence. La valeur par défaut de la propriété HtmlSaveOptions.ExportFrameScriptsAndProperties est true, c’est-à-dire ; l’exportation se fait selon les normes Excel. Cependant, si la propriété est définie sur false, le API ne sera pasgénérer les scripts liés aux cadres et aux commentaires conditionnels. Dans ce cas, le HTML résultant peut être visualisé correctement dans n’importe quel navigateur, cependant, il ne peut pas être réimporté à l’aide des API Aspose.Cells.

Voici le scénario d’utilisation simple.

 //Load the spreadsheet

Workbook book = new Workbook(filePath);

//Disable exporting frame scripts and document properties

HtmlSaveOptions options = new HtmlSaveOptions();

options.ExportFrameScriptsAndProperties = false;

//Save spreadsheet as HTML

book.Save("output.html", options);

Propriété Shape.MarcoName ajoutée

Aspose.Cells for .NET 8.6.0 a exposé la propriété Shape.MarcoName qui peut être utilisée pouraffecter n’importe quel module VBA à un contrôle de formulaire un tel bouton afin de fournir l’interaction. La propriété est de type chaîne, elle peut donc accepter le nom du module et l’attribuer au contrôle.

Voici le scénario d’utilisation simple.

 //Create an instance of Workbook

Workbook workbook = new Workbook();

//Access first default worksheet

Worksheet sheet = workbook.Worksheets[0];

//Add a module to the worksheet

int moduleIdx = workbook.VbaProject.Modules.Add(sheet);

//Access newly added module from the collection

VbaModule module = workbook.VbaProject.Modules[moduleIdx];

//Add code to the module

module.Codes =

    "Sub ShowMessage()" + "\r\n" +

    "    MsgBox \"Welcome to Aspose!\"" + "\r\n" +

    "End Sub";

//Add a Button on the worksheet and set its various properties

Aspose.Cells.Drawing.Button button = sheet.Shapes.AddButton(2, 0, 2, 0, 28, 80);

button.Placement = Aspose.Cells.Drawing.PlacementType.FreeFloating;

button.Font.Name = "Tahoma";

button.Font.IsBold = true;

button.Font.Color = System.Drawing.Color.Blue;

button.Text = "Aspose";

//Assign the VBA module to the button

button.MacroName = sheet.Name + ".ShowMessage";

//Save the result

workbook.Save("output.xlsm");

Propriété OoxmlSaveOptions.UpdateZoom ajoutée

Avec la version v8.6.0, le Aspose.Cells for .NET API a exposé la propriété OoxmlSaveOptions.UpdateZoom qui peut être utilisée pour mettre à jour PageSetup.Zoom si les propriétés PageSetup.FitToPagesWide et/ou PageSetup.FitToPagesTall ont été utilisées pour contrôler la mise à l’échelle de la feuille de calcul.

Public API Changements dans Aspose.Cells 8.5.2 Public API Changements dans Aspose.Cells 8.6.1