Public API Changements dans Aspose.Cells 8.7.0

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

API ajoutées

Prise en charge de la signature numérique, de la détection et de l’extraction du projet VBA

Cette version de Aspose.Cells for .NET a exposé de nouvelles propriétés et méthodes pour aider les utilisateurs dans des tâches telles que la signature numérique d’un projet VBA, la détection si un projet VBA est signé et valide. De plus, le nouveau API permet d’extraire le certificat sous forme de données brutes à partir d’un projet VBA signé numériquement dans Workbook.

Signer numériquement le projet VBA

Aspose.Cells for .NET 8.7.0 a exposé la méthode VbaProject.Sign qui peut être utilisée poursigner numériquement le projet VBA dans un classeur. Ladite méthode accepte une instance de la classe DigitalSignature qui réside dans l’espace de noms Aspose.Cells.DigitalSignatures.

Voici le scénario d’utilisation simple.

C#

 //Create an instance of Workbook

//Optionally load an existing spreadsheet

var book = new Workbook();

//Access the VbaProject from the Workbook

var vbaProject = book.VbaProject;

//Sign the VbaProject using the X509Certificate

vbaProject.Sign(new DigitalSignature(new System.Security.Cryptography.X509Certificates.X509Certificate2(cert), "Comments", DateTime.Now));

Détection d’un projet VBA signé numériquement

La propriété VbaProject.IsSigned nouvellement exposée peut être utilisée pourdétecter si le projet VBA dans un classeur est signé numériquement. La propriété VbaProject.IsSigned est de type booléen, qui renvoie true si le projet VBA est signé numériquement et vice versa.

Voici le scénario d’utilisation simple.

C#

 //Create an instance of Workbook and load an existing spreadsheet

var book = new Workbook(inFilePath);

//Access the VbaProject from the Workbook

var vbaProject = book.VbaProject;

//Check if VbaProject is digitally signed

if (vbaProject.IsSigned)

{

    Console.WriteLine("VbaProject is digitally signed");

}

else

{

    Console.WriteLine("VbaProject is not digitally signed");

}

Extraction de la signature numérique du projet VBA

Cette révision du API a également exposé la propriété VbaProject.CertRawData qui permet deextraire les données brutes du certificat numérique du projet VBA. La propriété VbaProject.CertRawData est de type tableau d’octets, qui contiendra les données brutes du certificat si le projet VBA est signé numériquement, sinon ladite propriété sera nulle.

Voici le scénario d’utilisation simple.

C#

 //Create an instance of Workbook and load an existing spreadsheet

var book = new Workbook(inFilePath);

//Access the VbaProject from the Workbook

var vbaProject = book.VbaProject;

//Extract digital signature in an array of bytes

var cert = vbaProject.CertRawData;

Valider la signature numérique du projet VBA

Un autre ajout au public API est la propriété VbaProject.IsValidSigned qui pourrait être utile dansvalider la signature numérique du projet VBA. Ladite propriété renvoie true si la signature numérique est valide et false si la signature est invalide.

Voici le scénario d’utilisation simple.

C#

 //Create an instance of Workbook and load an existing spreadsheet

var book = new Workbook(inFilePath);

//Access the VbaProject from the Workbook

var vbaProject = book.VbaProject;

//Check if VbaProject is digitally signed

if (vbaProject.IsSigned)

{

    //Check if signature is valid

    if (vbaProject.IsValidSigned)

    {

        Console.WriteLine("VbaProject is digitally signed & signature is valid");

    }

}

Méthode Protection.VerifyPassword ajouté

Aspose.Cells for .NET 8.7.0 a exposé la méthode Protection.VerifyPassword qui peut être utilisée pourvérifier le mot de passe utilisé pour protéger la feuille de travailCette méthode accepte une instance de chaîne comme paramètre et renvoie true si le mot de passe spécifié correspond au mot de passe utilisé pour protéger la feuille de calcul.

Voici le scénario d’utilisation simple.

C#

 //Create an instance of Workbook and load an existing spreadsheet

var book = new Workbook(inFilePath);

//Access the desired Worksheet via its index or name

var sheet = book.Worksheets[0];

//Access Protection module of desired Worksheet

var protection = sheet.Protection;

//Verify the password for Worksheet

if (protection.VerifyPassword(password))

{

    Console.WriteLine("Password has matched");

}

else

{

    Console.WriteLine("Password did not match");

}

Protection de la propriété.IsProtectedWithPassword ajouté

Cette version de Aspose.Cells for .NET API a également exposé la propriété Protection.IsProtectedWithPassword qui peut être utile dansdétecter si une feuille de travail est protégée par un mot de passe ou non.

Voici le scénario d’utilisation simple.

C#

 //Create an instance of Workbook and load an existing spreadsheet

var book = new Workbook(inFilePath);

//Access the desired Worksheet via its index or name

var sheet = book.Worksheets[0];

//Access Protection module of desired Worksheet

var protection = sheet.Protection;

//Check if Worksheet is password protected

if (protection.IsProtectedWithPassword)

{

    Console.WriteLine("Worksheet is password protected");

}

else

{

    Console.WriteLine("Worksheet is not password protected");

}

Propriété ColorScale.Is3ColorScale ajoutée

Aspose.Cells for .NET 8.7.0 a exposé la propriété ColorScale.Is3ColorScale qui peut être utilisée pour créer un format conditionnel 2-Color Scale. Ladite propriété est de type booléen avec la valeur par défaut true, ce qui signifie que le format conditionnel sera de 3-Color Scale par défaut. Cependant, passer la propriété ColorScale.Is3ColorScale à falsegénérer un format conditionnel d’échelle à 2 couleurs.

Voici le scénario d’utilisation simple.

C#

 //Create an instance of Workbook

//Optionally load an existing spreadsheet

var book = new Workbook();

//Access the Worksheet to which conditional formatting rule has to be added

var sheet = book.Worksheets[0];

//Add FormatConditions to the collection

int index = sheet.ConditionalFormattings.Add();

//Access newly added formatConditionCollection via its index

var formatConditionCollection = sheet.ConditionalFormattings[index];

//Create a CellArea on which conditional formatting rule will be applied

var cellArea = CellArea.CreateCellArea("A1", "A5");

//Add conditional formatted cell range

formatConditionCollection.AddArea(cellArea);

//Add format condition of type ColorScale

index = formatConditionCollection.AddCondition(FormatConditionType.ColorScale);

//Access newly added format condition via its index

var formatCondition = formatConditionCollection[index];

//Set Is3ColorScale to false in order to generate a 2-Color Scale format

formatCondition.ColorScale.Is3ColorScale = false;

//Set other necessary properties

Propriété TxtLoadOptions.HasFormula ajoutée

Aspose.Cells for .NET 8.7.0 a fourni un support pouridentifier et analyser les formules lors du chargement des fichiers CSV/TXT ayant des données simples délimitées. La propriété TxtLoadOptions.HasFormula nouvellement exposée, lorsqu’elle est définie sur true, ordonne au API d’analyser les formules du fichier délimité d’entrée et de les définir sur les cellules pertinentes sans nécessiter de traitement supplémentaire.

Voici le scénario d’utilisation simple.

C#

 //Create an instance of TxtLoadOptions

var options = new TxtLoadOptions();

//Set HasFormula property to true

options.HasFormula = true;

//Set the Separator property as desired

options.Separator = ',';

//Load the CSV/TXT file using the instance of TxtLoadOptions

var book = new Workbook(inFilePath, options);

//Calculate formulas in order to get the calculated values of formula in CSV

book.CalculateFormula();

//Write result in any of the supported formats

book.Save(outFilePath);

Propriété DataLabels.IsResizeShapeToFitText ajoutée

Une autre fonctionnalité utile que Aspose.Cells for .NET 8.7.0 a exposée est la propriété DataLabels.IsResizeShapeToFitText qui peut activer leRedimensionner la forme pour l’adapter au textefonctionnalité de l’application Excel pour les étiquettes de données du graphique.

Voici le scénario d’utilisation simple.

C#

 //Create an instance of Workbook containing the Chart

var book = new Workbook(inFilePath);

//Access the Worksheet that contains the Chart

var sheet = book.Worksheets[0];

//Access the desired Chart via its index or name

var chart = sheet.Charts[0];

//Access the DataLabels of desired NSeries

var labels = chart.NSeries[0].DataLabels;

//Set ResizeShapeToFitText property to true

labels.IsResizeShapeToFitText = true;

//Calculate Chart

chart.Calculate();

Propriété PdfSaveOptions.OptimizationType ajoutée

Aspose.Cells for .NET 8.7.0 a exposé la propriété PdfSaveOptions.OptimizationType avec l’énumération PdfOptimizationType afin de faciliter les utilisateurs àchoisissez l’algorithme d’optimisation souhaité lors de l’exportation des feuilles de calcul au format PDF. Il existe 2 valeurs possibles pour la propriété PdfSaveOptions.OptimizationType comme détaillé ci-dessous.

PdfOptimizationType.MinimumSize : la qualité est compromise pour la taille du fichier résultant.
PdfOptimizationType.Standard : la qualité n’est pas compromise, de sorte que la taille du fichier résultant sera importante.

Voici le scénario d’utilisation simple.

C#

 //Create an instance of PdfSaveOptions

var pdfSaveOptions = new PdfSaveOptions();

//Set the OptimizationType property to desired value

pdfSaveOptions.OptimizationType = PdfOptimizationType.MinimumSize;

//Create an instance of Workbook

//Optionally load an existing spreadsheet

var book = new Workbook(inFilePath);

//Save the spreadsheet in PDF format while passing the instance of PdfSaveOptions

book.Save(outFilePath, pdfSaveOptions);

API supprimées

Propriété Workbook.SaveOptions supprimé

La propriété Workbook.SaveOptions a été marquée comme obsolète il y a quelque temps. Avec cette version, il a été complètement supprimé du public API, il est donc conseillé d’utiliser la méthode Workbook.Save(Stream, SaveOptions) ou Workbook.Save(string, SaveOptions) comme alternative.

Public API Changements dans Aspose.Cells 8.6.3 Public API Changements dans Aspose.Cells 8.7.1