Aspose.Cells for .NET 17.02.0 Notes de mise à jour

Public API et modifications incompatibles avec les versions antérieures

Vous trouverez ci-dessous une liste de toutes les modifications apportées au public API, telles que les membres ajoutés, renommés, supprimés ou obsolètes, ainsi que toute modification non rétrocompatible apportée à Aspose.Cells for .NET. Si vous avez des inquiétudes concernant l’un des changements répertoriés, veuillez le signaler dans le forum d’assistance Aspose.Cells.

Ajout de la propriété HTMLLoadOptions.AutoFitColsAndRows

Cette version du Aspose.Cells for .NET API a ajouté la propriété HTMLLoadOptions.AutoFitColsAndRows qui indique si le API doit ajuster automatiquement les colonnes et les lignes lors de l’importation du HTML dans son mode objet. La propriété de type booléen a la valeur par défaut false, ce qui signifie que les hauteurs et largeurs de cellule seront importées telles quelles. Cependant, lorsque la propriété susmentionnée est définie sur true, le API essaie d’ajuster les largeurs de colonne et les hauteurs de ligne en fonction du contenu. .

Voici le scénario d’utilisation simple de la propriété HTMLLoadOptions.AutoFitColsAndRows.

 // Create an instance of HTMLLoadOptions

var loadOptions = new HTMLLoadOptions();

// Set the AutoFitColsAndRows property to true

loadOptions.AutoFitColsAndRows = true;

// Create an instance of Workbook and load HTML while passing

// the object of HTMLLoadOptions class created above

var book = new Workbook(dir + "sample.htm", loadOptions);

Ajout des propriétés LoadOptions.WarningCallback et WorkbookSettings.WarningCallback

Aspose.Cells for .NET 17.02.0 a exposé la propriété WarningCallback aux classes LoadOptions et WorkbookSettings afin d’obtenir ou de définir le rappel d’avertissement. Les développeurs doivent implémenter l’interface IWarningCallback afin d’obtenir des avertissements personnalisés dans leurs applications.

Voici un scénario d’utilisation simple de la propriété LoadOptions.WarningCallback pour obtenir des avertissements lorsqu’une feuille de calcul d’entrée contient des plages nommées en double.

 public class WarningCallback : IWarningCallback

{

    public void Warning(WarningInfo warningInfo)

    {

        if (warningInfo.WarningType == WarningType.DuplicateDefinedName)

        {

            Console.WriteLine("Duplicate Defined Names Found as " + warningInfo.Description);

        }

    }

}

Voici comment utiliser la classe personnalisée définie ci-dessus.

 // Create an instance of LoadOptions class

var options = new LoadOptions();

// Set the WarningCallback property to custom class

options.WarningCallback = new WarningCallback();

// Load a sample spreadsheet in an instance of Workbook while 

// passing the object of LoadOptions class as defined above

var book = new Workbook(dir + "sample.xlsx", options);

Ajout de la méthode Cells.TextToColumns

La dernière révision des API Aspose.Cells for .NET a exposé la méthode Cells.TextToColumns afin d’imiter celle d’Excel.Texte aux colonnes caractéristique. Excel fournit cette fonctionnalité à partir deOutils de données sous leDonnéeslanguette. Veuillez noter que pour diviser le contenu d’une colonne en plusieurs colonnes, les données doivent contenir un délimiteur spécifique tel qu’une virgule (ou tout autre caractère) sur la base duquel le API essaie de diviser le contenu d’une cellule en plusieurs cellules.

Voici un scénario d’utilisation simple pour démontrer l’utilisation de API nouvellement exposé.

 // Create an instance of Workbook and load a sample

var book = new Workbook(dir + "sample.xlsx");

// Retrieve the cells collection of the first worksheet in the sample

var cells = book.Worksheets[0].Cells;

// Create an instance of TxtLoadOptions

var options = new TxtLoadOptions();

// Specify the separator

options.Separator = ',';

// Split the data in range B2:B4

cells.TextToColumns(1, 1, 3, options);

Ajout de la méthode Workbook.GetFonts

Aspose.Cells for .NET 17.02.0 a exposé la méthode GetFonts pour la classe Workbook. La méthode Workbook.GetFonts renvoie la liste des polices individuelles utilisées pour formater le contenu des cellules d’une feuille de calcul donnée. Le type de retour de la méthode susmentionnée est un tableau de type Aspose.Cells.Font class.

L’extrait de code suivant illustre l’utilisation de la méthode Workbook.GetFonts.

 // Create an instance of Workbook and load a sample

var book = new Workbook(dir + "sample.xlsx");

// Retrieve the list of fonts used in spreadsheet

var fonts = book.GetFonts();

// Iterate the list and write font name

foreach (Aspose.Cells.Font font in fonts)

{

    Console.WriteLine(font.Name);

}

Ajout de la propriété TxtSaveOptions.TrimLeadingBlankRowAndColumn

Cette révision de Aspose.Cells for .NET a exposé la propriété de type booléen TrimLeadingBlankRowAndColumn pour la classe TxtSaveOptions qui indique si les premières lignes et colonnes vides doivent être coupées comme le fait Excel lors de l’exportation de données vers CSV ou des formats délimités par des tabulations. La valeur par défaut de la propriété susmentionnée est false. Si les données de la feuille de calcul ne commencent pas à partir de la première cellule, c’est-à-dire : A1, l’application Excel supprime les premières lignes et colonnes vides lors de l’exportation des données vers les formats CSV ou délimités par des tabulations. Cependant, les API Aspose.Cells par défaut conservent les lignes et colonnes vides pour le même échantillon afin de conserver l’emplacement des données si les fichiers exportés CSV ou délimités par des tabulations doivent être réimportés à l’aide des API Aspose.Cells.

Voici un scénario d’utilisation simple de la propriété TrimLeadingBlankRowAndColumn.

 // Create an instance of Workbook and load a sample

var book = new Workbook(dir + "sample.xlsx");

// Create an instance of TxtSaveOptions

var options = new TxtSaveOptions();

// Set TrimLeadingBlankRowAndColumn property to true

options.TrimLeadingBlankRowAndColumn = true;

// Export to CSV format while removing the leading blank rows & columns

book.Save(dir + "output.csv", options);

Propriété BuiltInDocumentPropertyCollection.Revision ajoutée et propriété BuiltInDocumentPropertyCollection.RevisionNumber obsolète

Veuillez utiliser la propriété BuiltInDocumentPropertyCollection.Revision à la place.

Ajout de la propriété Shape.TextShapeType

La propriété Shape.TextShapeType obtient ou définit le type de forme de texte prédéfini à partir d’une liste de types prédéfinis stockés dans l’énumération AutoShapeType.

Ajout de la propriété ExportTableOptions.RenameStrategy et de l’énumération RenameStrategy

Aspose.Cells for .NET 17.02.0 a exposé la propriété ExportTableOptions.RenameStrategy avec l’énumération RenameStrategy afin de gérer le scénario où la première ligne de données à exporter contient des entrées en double. Si la propriété ExportTableOptions.ExportColumnName est définie sur true, le API provoquera une exception indiquant qu’un DataTable ne peut pas avoir de colonnes portant les mêmes noms. Avec les nouvelles modifications en place, le API permet d’ajouter des chiffres ou des lettres aux noms de colonne en double tandis que la valeur appropriée de l’énumération RenameStrategy décide comment renommer les noms de colonne en double.

Voici un scénario d’utilisation simple illustrant les API nouvellement exposées.

 // Create an instance of Workbook

var book = new Workbook();

// Retrieve the cells collection of first worksheet

var cells = book.Worksheets[0].Cells;

// Insert similar values in first row

// These values will serve as column names while exporting to DataTable

cells["A1"].PutValue("Column A");

cells["B1"].PutValue("Column A");

cells["C1"].PutValue("Column A");

// Insert some more data that will serve as first row of DataTable

cells["A2"].PutValue("Value 1");

cells["B2"].PutValue("Value 2");

cells["C2"].PutValue("Value 3");

// Create an instance of ExportTableOptions

var options = new ExportTableOptions();

// Set ExportColumnName property to true so that the 

// first row of worksheet data becomes the columns names of DataTable

options.ExportColumnName = true;

// Set the renaming strategy to Letter, 

// indicating the the API will append letters to duplicate column names

options.RenameStrategy = RenameStrategy.Letter;

// Export the data to DataTable while using the object of ExportTableOptions class

var table = cells.ExportDataTable(0, 0, 2, 3, options);

Ajout des méthodes GridDesktop.DoSplit et GridDesktop.UnDoSplit

Aspose.Cells.GridDesktop for .NET 17.02.0 a fourni deux nouvelles méthodes qui pourraient diviser le contenu de la feuille de calcul en volets ou fusionner les volets existants.

Exemples d’utilisation

Veuillez consulter la liste des rubriques d’aide ajoutées dans les documents Wiki Aspose.Cells :

1. Ajustement automatique des colonnes et des lignes lors du chargement de HTML dans le classeur
2. Convertir du texte en colonnes à l’aide de Aspose.Cells
3. Obtenir une liste des polices utilisées dans une feuille de calcul ou un classeur
4. Obtenir des avertissements lors du chargement du fichier Excel
5. Lire et manipuler des graphiques Excel 2016
6. Coupez les premières lignes et colonnes vides lors de l’exportation des feuilles de calcul au format CSV
7. Liaison de feuille de calcul à un objet de collection personnalisé à l’aide de GridWeb
8. Renommer automatiquement les colonnes en double lors de l’exportation des données de la feuille de calcul
9. Fractionner les volets dans la feuille de calcul GridDesktop