Δημόσιο API και Μη συμβατές αλλαγές προς τα πίσω

Ακολουθεί μια λίστα με τυχόν αλλαγές που έγιναν στο κοινό API, όπως προστέθηκαν, μετονομάστηκαν, αφαιρέθηκαν ή καταργήθηκαν μέλη, καθώς και οποιαδήποτε αλλαγή που δεν είναι συμβατή προς τα πίσω στο Aspose.Cells for .NET. Εάν έχετε ανησυχίες σχετικά με οποιαδήποτε αλλαγή που αναφέρεται, παρακαλούμε να το αναφέρετε στο το φόρουμ υποστήριξης Aspose.Cells.

Προστέθηκε η ιδιότητα HTMLLoadOptions.AutoFitColsAndRows

Αυτή η έκδοση του Aspose.Cells for .NET API έχει προσθέσει την ιδιότητα HTMLLoadOptions.AutoFitColsAndRows, η οποία υποδεικνύει εάν το API πρέπει να προσαρμόζεται αυτόματα στις στήλες και τις σειρές κατά την εισαγωγή της λειτουργίας HTML στη λειτουργία του. Η ιδιότητα τύπου Boolean έχει την προεπιλεγμένη τιμή ως false, πράγμα που σημαίνει ότι τα ύψη και τα πλάτη των κελιών θα εισαχθούν ως έχουν, ωστόσο, όταν η προαναφερθείσα ιδιότητα οριστεί σε true, το API προσπαθεί να προσαρμόσει τα πλάτη στηλών και τα ύψη σειρών σύμφωνα με τα περιεχόμενα .

Εδώ είναι το απλό σενάριο χρήσης της ιδιότητας 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);

Προστέθηκαν LoadOptions.WarningCallback & WorkbookSettings.WarningCallback Properties

Aspose.Cells for .NET 17.02.0 έχει εκθέσει την ιδιότητα WarningCallback στις κλάσεις LoadOptions και WorkbookSettings προκειμένου να λάβει ή να ορίσει την προειδοποίηση επιστροφής κλήσης. Οι προγραμματιστές πρέπει να εφαρμόσουν τη διεπαφή IWarningCallback για να λαμβάνουν προσαρμοσμένες προειδοποιήσεις στις εφαρμογές τους.

Ακολουθεί ένα απλό σενάριο χρήσης της ιδιότητας LoadOptions.WarningCallback για να λαμβάνετε προειδοποιήσεις όταν ένα υπολογιστικό φύλλο εισόδου περιέχει διπλότυπα εύρη με όνομα.

 public class WarningCallback : IWarningCallback

{

    public void Warning(WarningInfo warningInfo)

    {

        if (warningInfo.WarningType == WarningType.DuplicateDefinedName)

        {

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

        }

    }

}

Ακολουθεί ο τρόπος χρήσης της προσαρμοσμένης κλάσης που ορίζεται παραπάνω.

 // 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);

Προστέθηκε Cells.TextToColumns Method

Η τελευταία αναθεώρηση των API Aspose.Cells for .NET έχει εκθέσει τη μέθοδο Cells.TextToColumns προκειμένου να μιμηθεί τη μέθοδο του ExcelΚείμενο σε στήλες χαρακτηριστικό. Το Excel παρέχει αυτήν τη δυνατότητα απόΕργαλεία Δεδομένων σύμφωνα με τοΔεδομένα αυτί. Λάβετε υπόψη ότι για να χωρίσετε τα περιεχόμενα μιας στήλης σε πολλές στήλες, τα δεδομένα θα πρέπει να περιέχουν ένα συγκεκριμένο οριοθέτη, όπως κόμμα (ή οποιονδήποτε άλλο χαρακτήρα) βάσει του οποίου το API προσπαθεί να χωρίσει τα περιεχόμενα ενός κελιού σε πολλά κελιά.

Ακολουθεί ένα απλό σενάριο χρήσης για να αποδείξετε τη χρήση του πρόσφατα εκτεθειμένου API.

 // 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);

Προστέθηκε Workbook.GetFonts Method

Aspose.Cells for .NET 17.02.0 παρουσίασε τη μέθοδο GetFonts για την κλάση Βιβλίο εργασίας. Η μέθοδος Workbook.GetFonts επιστρέφει τη λίστα μεμονωμένων γραμματοσειρών που χρησιμοποιούνται για τη μορφοποίηση των περιεχομένων των κελιών ενός δεδομένου υπολογιστικού φύλλου. Ο τύπος επιστροφής της προαναφερθείσας μεθόδου είναι ένας πίνακας τύπου Aspose.Cells.Font class.

Το παρακάτω απόσπασμα κώδικα δείχνει τη χρήση της μεθόδου 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);

}

Προστέθηκε η ιδιότητα TxtSaveOptions.TrimLeadingBlankRowAndColumn

Αυτή η αναθεώρηση του Aspose.Cells for .NET έχει εκθέσει την ιδιότητα τύπου Boolean TrimLeadingBlankRowAndColumn για την κλάση TxtSaveOptions, η οποία υποδεικνύει εάν οι κύριες κενές γραμμές και στήλες πρέπει να περικοπούν όπως το Excel κατά την εξαγωγή δεδομένων σε CSV, η προεπιλεγμένη τιμή της ιδιότητας formatseemen ή Tab-. Σε περίπτωση που τα δεδομένα στο φύλλο εργασίας δεν ξεκινούν από το πρώτο κελί, δηλαδή: A1, η εφαρμογή Excel αφαιρεί τις κύριες κενές γραμμές και στήλες ενώ εξάγει τα δεδομένα σε μορφές CSV ή οριοθετημένες με Tab, ωστόσο, τα Aspose.Cells API από προεπιλογή, διατηρούν τις κενές γραμμές και στήλες για το ίδιο δείγμα, προκειμένου να διατηρηθεί η τοποθεσία δεδομένων, εάν τα εξαγόμενα αρχεία CSV ή οριοθετημένα με Tab πρέπει να εισαχθούν ξανά χρησιμοποιώντας Aspose.Cells API.

Ακολουθεί ένα απλό σενάριο χρήσης της ιδιότητας 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);

Προστέθηκε BuiltInDocumentPropertyCollection.Revision Property & Obsoleted BuiltInDocumentPropertyCollection.RevisionNumber Property

Χρησιμοποιήστε αντί αυτού την ιδιότητα BuiltInDocumentPropertyCollection.Revision.

Προστέθηκε η ιδιότητα Shape.TextShapeType

Η ιδιότητα Shape.TextShapeType λαμβάνει ή ορίζει τον προκαθορισμένο τύπο σχήματος κειμένου από μια λίστα προκαθορισμένων τύπων που είναι αποθηκευμένοι στην απαρίθμηση AutoShapeType.

Προστέθηκε το ExportTableOptions.RenameStrategy Property και RenameStrategy Enumeration

Aspose.Cells for .NET 17.02.0 έχει εκθέσει την ιδιότητα ExportTableOptions.RenameStrategy μαζί με την απαρίθμηση RenameStrategy προκειμένου να αντιμετωπιστεί το σενάριο όπου η πρώτη σειρά δεδομένων προς εξαγωγή περιέχει διπλότυπες εγγραφές. Εάν η ιδιότητα ExportTableOptions.ExportColumnName έχει οριστεί ως αληθής, το API θα προκαλέσει εξαίρεση που υποδεικνύει ότι ένας πίνακας δεδομένων δεν μπορεί να έχει στήλες με τα ίδια ονόματα. Με νέες αλλαγές, το API επιτρέπει είτε την προσθήκη ψηφίων ή γραμμάτων στα διπλότυπα ονόματα στηλών, ενώ η κατάλληλη τιμή από την απαρίθμηση RenameStrategy αποφασίζει πώς να μετονομάσετε τα διπλότυπα ονόματα στηλών.

Ακολουθεί ένα απλό σενάριο χρήσης που δείχνει τα πρόσφατα εκτεθειμένα API.

 // 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);

Προστέθηκαν GridDesktop.DoSplit & GridDesktop.UnDoSplit Methods

Aspose.Cells.GridDesktop for .NET 17.02.0 παρείχε δύο νέες μεθόδους που θα μπορούσαν είτε να χωρίσουν τα περιεχόμενα του φύλλου εργασίας σε παράθυρα είτε να συγχωνεύσουν τα υπάρχοντα παράθυρα.

Παραδείγματα χρήσης

Ελέγξτε τη λίστα των θεμάτων βοήθειας που έχουν προστεθεί στα έγγραφα του Wiki Aspose.Cells:

1. Αυτόματη προσαρμογή στηλών και σειρών κατά τη φόρτωση του HTML στο βιβλίο εργασίας
2. Μετατροπή κειμένου σε στήλες χρησιμοποιώντας το Aspose.Cells
3. Λάβετε μια λίστα γραμματοσειρών που χρησιμοποιούνται σε ένα υπολογιστικό φύλλο ή ένα βιβλίο εργασίας
4. Λάβετε προειδοποιήσεις κατά τη φόρτωση του αρχείου Excel
5. Διαβάστε και χειριστείτε τα γραφήματα του Excel 2016
6. Περικοπή κορυφαίων κενών γραμμών και στηλών κατά την εξαγωγή υπολογιστικών φύλλων σε μορφή CSV
7. Σύνδεση φύλλου εργασίας σε ένα αντικείμενο προσαρμοσμένης συλλογής χρησιμοποιώντας το GridWeb
8. Μετονομάστε αυτόματα διπλότυπες στήλες κατά την εξαγωγή δεδομένων φύλλου εργασίας
9. Διαίρεση πλαισίων στο φύλλο εργασίας GridDesktop