Öffentliche API Änderungen in Aspose.Cells 8.0.0

Diese Seite listet öffentliche API-Änderungen auf, die in Aspose.Cells 8.0.0 eingeführt wurden. Es umfasst nicht nur neue und veraltete öffentliche Methoden, sondern auch eine Beschreibung von Änderungen im Verhalten im Hintergrund von Aspose.Cells, die den vorhandenen Code beeinflussen können.

MemorySetting zu LoadOptions & WorkbookSettings hinzugefügt

Ab v8.0.0 von Aspose.Cells for Java haben wir Speichernutzungsoptionen aus Leistungsgründen bereitgestellt. Die MemorySetting-Eigenschaft ist nun in den Klassen LoadOptions & WorkbookSettings verfügbar.

Beispiel

Zeigt, wie eine Excel-Datei (mit großer Größe) im optimierten Modus gelesen wird.

Java

 //Initialize LoadOptions

LoadOptions options = new LoadOptions();

//Set memory preferences

options.setMemorySetting(MemorySetting.MEMORY_PREFERENCE);

//Instantiate the Workbook with an object of LoadOptions

Workbook book = new Workbook(myDir + "large.xlsx", options);

Zeigt, wie ein großes Dataset im optimierten Modus in ein Arbeitsblatt geschrieben wird.

Java

 //Instantiate a new Workbook

Workbook book = new Workbook();

//Set the memory preferences for WorkbookSettings

book.getSettings().setMemorySetting(MemorySetting.MEMORY_PREFERENCE);

//Input large data into the cells

//.........

Bitte überprüfen Sie den ausführlichen Artikel zu Optimizing Memory while Working with Large File.

Implementierungen von Zeile & Zelle wurden geändert

In früheren Versionen wurden Zeilen- und Zellenobjekte im Speicher gehalten, um die entsprechende Zeile und Zelle in einem Arbeitsblatt darzustellen. Die gleiche Instanz wurde zurückgegeben, wann immer RowCollection[int index] oder Cells[int row, int column] abgerufen wurde. Aus Gründen der Speicherleistung werden jetzt nur noch Eigenschaften und Daten von Zeile und Zelle im Speicher behalten. Daher sind das Zeilen- und Zellenobjekt nun die Wrapper für die genannten Eigenschaften.

Beispiel

Zeigt, wie man die Zellen- und Zeilenobjekte von jetzt an vergleicht.

Java

 //..

row1.equals(row2);


cell1.equals(cell2);

//..

Da die Zeilen- und Zellenobjekte je nach Aufruf instanziiert werden, werden sie nicht vom Zellenkomponenten im Speicher behalten und verwaltet. Daher können nach einigen Einfüge- und Löschvorgängen die Zeilen- und Spaltenindizes nicht aktualisiert werden oder diese Objekte werden ungültig.

Beispiel

Beispielsweise gibt der folgende Codeausschnitt ab Version 8.0.0 und höher ungültige Ergebnisse zurück,

Java

 Cell cell = cells.get("A2");

System.out.println(cell.getName() + ":" + cell.getValue());

cells.insertRange(CellArea.createCellArea("A1", "A1"), ShiftType.DOWN);

System.out.println(cell.getName() + ":" + cell.getValue());

Mit der neuen Version wird das Zellenobjekt ungültig oder verweist auf A2 mit einem unerwünschten Wert. Um eine solche Situation zu vermeiden, holen Sie die Zeilen- oder Zellenobjekte erneut aus der Zellensammlung, um das korrekte Ergebnis zu erhalten.

Java

 Cell cell = cells.get("A2");

System.out.println(cell.getName() + ":" + cell.getValue());

cells.insertRange(CellArea.createCellArea("A1", "A1"), ShiftType.DOWN);

//Fetch the cell reference again

Cell cell = cells.get("A3");

System.out.println(cell.getName() + ":" + cell.getValue());

RowCollection erbt nicht mehr von CollectionBase, da es kein Zeilenobjekt in seiner internen Liste gibt.

Cell.StringValue-Verhalten geändert

In früheren Versionen wurde das spezielle Muster _ beim Formatieren von Zellenwerten ignoriert, während das Sonderzeichen * immer ein Zeichen in das formatierte Ergebnis einfügte. Ab dieser Version haben wir die Logik zur Behandlung der Sonderzeichen _ und * geändert, um das formatierte Ergebnis identisch mit der Excel-Anwendung zu gestalten. Beispielsweise wurde das benutzerdefinierte Zellenformat “_($* #,##0.00_)” verwendet, um den Wert 123 darzustellen und produzierte das Ergebnis “$ 123.00”. Mit neuen Versionen enthält Cell.StringValue das Ergebnis als “$123.00”, was dem Verhalten der Excel-Anwendung entspricht, wenn die Zelle zum Kopieren in Text oder zum Exportieren in CSV verwendet wird.

Erstellungszeit zu PdfSaveOptions hinzugefügt

Nutzer können nun die Erstellungszeit von PDF beim Speichern des Tabellenblatts in PDF mithilfe der Klasse PdfSaveOptions festlegen oder abrufen.

ShowFormulas zu Arbeitsblatt hinzugefügt

Nutzer können ab sofort die boolesche Eigenschaft ShowFormulas des Arbeitsblatts verwenden, um die Ansicht zwischen Formel und Wert eines bestimmten Arbeitsblatts zu wechseln.

Ooxml zu FileFormatType hinzugefügt

Eine neue Konstante Ooxml wurde der Klasse FileFormatType hinzugefügt, um die verschlüsselten Office Open XML-Dateien wie XLSX, DOCX, PPTX und mehr zu repräsentieren.

FilterColumnCollection von AutoFilter veraltet

Mit Aspose.Cells for Java wurde die Methode getFilterColumnCollection als veraltet markiert. Es wird empfohlen stattdessen die Methode AuotFilter.getFilterColumns zu verwenden.

Ersetzte SeriesCollection.SecondCatergoryData durch SeriesCollection.SecondCategoryData

Wir haben den Tippfehler im Methodennamen SeriesCollection.getSecondCatergoryData korrigiert. Sie können nun die Methode SeriesCollection.getSecondCategoryData verwenden, während die ursprüngliche Methode SeriesCollection.getSecondCatergoryData als veraltet markiert wurde.