Aspose.Cells for .NET 17.02.0 Versionshinweise

Öffentliche API und rückwärts inkompatible Änderungen

Im Folgenden finden Sie eine Liste aller Änderungen, die an der öffentlichen API vorgenommen wurden, z. B. hinzugefügte, umbenannte, entfernte oder veraltete Mitglieder, sowie alle nicht abwärtskompatiblen Änderungen, die an Aspose.Cells for .NET vorgenommen wurden. Wenn Sie Bedenken zu einer der aufgeführten Änderungen haben, äußern Sie sie bitte das Aspose.Cells Support-Forum.

HTMLLoadOptions.AutoFitColsAndRows-Eigenschaft hinzugefügt

Diese Version von Aspose.Cells for .NET API hat die Eigenschaft HTMLLoadOptions.AutoFitColsAndRows hinzugefügt, die angibt, ob API Spalten und Zeilen automatisch anpassen soll, während HTML in seinem Objektmodus importiert wird. Die Eigenschaft Boolean type hat den Standardwert false, was bedeutet, dass die Zellenhöhen und -breiten so importiert werden, wie sie sind. Wenn die oben genannte Eigenschaft jedoch auf true gesetzt ist, versucht der API, die Spaltenbreiten und Zeilenhöhen entsprechend dem Inhalt anzupassen .

Hier ist das einfache Verwendungsszenario der HTMLLoadOptions.AutoFitColsAndRows-Eigenschaft.

 // 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 hinzugefügt

Aspose.Cells for .NET 17.02.0 hat die WarningCallback-Eigenschaft für die LoadOptions- und WorkbookSettings-Klassen verfügbar gemacht, um den Warnungsrückruf abzurufen oder festzulegen. Entwickler müssen die IWarningCallback-Schnittstelle implementieren, um benutzerdefinierte Warnungen in ihren Anwendungen zu erhalten.

Hier ist ein einfaches Verwendungsszenario der LoadOptions.WarningCallback-Eigenschaft, um Warnungen zu erhalten, wenn eine Eingabetabelle doppelte benannte Bereiche enthält.

 public class WarningCallback : IWarningCallback

{

    public void Warning(WarningInfo warningInfo)

    {

        if (warningInfo.WarningType == WarningType.DuplicateDefinedName)

        {

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

        }

    }

}

So verwenden Sie die oben definierte benutzerdefinierte Klasse.

 // 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-Methode hinzugefügt

Die neueste Überarbeitung von Aspose.Cells for .NET APIs haben die Cells.TextToColumns-Methode verfügbar gemacht, um die von Excel nachzuahmenText in Spalten Merkmal. Excel bietet diese Funktion abDatenwerkzeuge unter demDatenTab. Bitte beachten Sie, dass zum Aufteilen des Inhalts einer Spalte auf mehrere Spalten die Daten ein bestimmtes Trennzeichen wie ein Komma (oder ein beliebiges anderes Zeichen) enthalten sollten, auf dessen Grundlage der API versucht, den Inhalt einer Zelle auf mehrere Zellen aufzuteilen.

Hier ist ein einfaches Nutzungsszenario, um die Nutzung des neu bereitgestellten API zu demonstrieren.

 // 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-Methode hinzugefügt

Aspose.Cells for .NET 17.02.0 hat die GetFonts-Methode für die Workbook-Klasse verfügbar gemacht. Die Workbook.GetFonts-Methode gibt die Liste der einzelnen Schriftarten zurück, die zum Formatieren der Zelleninhalte einer bestimmten Tabelle verwendet werden. Der Rückgabetyp der oben genannten Methode ist ein Array vom Typ Aspose.Cells.Font-Klasse.

Der folgende Codeausschnitt veranschaulicht die Verwendung der Workbook.GetFonts-Methode.

 // 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-Eigenschaft hinzugefügt

Diese Überarbeitung von Aspose.Cells for .NET hat die TrimLeadingBlankRowAndColumn-Eigenschaft des booleschen Typs für die TxtSaveOptions-Klasse verfügbar gemacht, die angibt, ob führende leere Zeilen und Spalten beim Exportieren von Daten in CSV- oder tabulatorgetrennte Formate wie in Excel gekürzt werden sollen. Der Standardwert der oben genannten Eigenschaft ist „false“. Falls die Daten auf dem Arbeitsblatt nicht mit der ersten Zelle beginnen, d. h.: A1, entfernt die Excel-Anwendung die führenden leeren Zeilen und Spalten, während die Daten in CSV- oder tabulatorgetrennte Formate exportiert werden, jedoch behalten Aspose.Cells-APIs standardmäßig bei die leeren Zeilen und Spalten für dieselbe Probe, um den Datenspeicherort beizubehalten, wenn die exportierten CSV- oder tabulatorgetrennten Dateien mithilfe von Aspose.Cells-APIs zurückimportiert werden müssen.

Hier ist ein einfaches Verwendungsszenario der TrimLeadingBlankRowAndColumn-Eigenschaft.

 // 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-Eigenschaft hinzugefügt und veraltete BuiltInDocumentPropertyCollection.RevisionNumber-Eigenschaft

Verwenden Sie stattdessen die Eigenschaft BuiltInDocumentPropertyCollection.Revision.

Shape.TextShapeType-Eigenschaft hinzugefügt

Die Shape.TextShapeType-Eigenschaft ruft oder legt den voreingestellten Textformtyp aus einer Liste vordefinierter Typen fest, die in der AutoShapeType-Enumeration gespeichert sind.

ExportTableOptions.RenameStrategy-Eigenschaft und RenameStrategy-Enumeration hinzugefügt

Aspose.Cells for .NET 17.02.0 hat die ExportTableOptions.RenameStrategy-Eigenschaft zusammen mit der RenameStrategy-Enumeration verfügbar gemacht, um ein Szenario zu bewältigen, in dem die erste zu exportierende Datenzeile doppelte Einträge enthält. Wenn die Eigenschaft „ExportTableOptions.ExportColumnName“ auf „true“ gesetzt ist, verursacht API eine Ausnahme, die angibt, dass eine DataTable keine Spalten mit demselben Namen haben darf. Mit neuen Änderungen ermöglicht API das Anhängen von Ziffern oder Buchstaben an die doppelten Spaltennamen, während der entsprechende Wert aus der RenameStrategy-Enumeration entscheidet, wie die doppelten Spaltennamen umbenannt werden.

Hier ist ein einfaches Nutzungsszenario, das die neu bereitgestellten APIs demonstriert.

 // 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- und GridDesktop.UnDoSplit-Methoden hinzugefügt

Aspose.Cells.GridDesktop for .NET 17.02.0 hat zwei neue Methoden bereitgestellt, die entweder den Inhalt des Arbeitsblatts in Bereiche aufteilen oder die vorhandenen Bereiche zusammenführen können.

Anwendungsbeispiele

Bitte überprüfen Sie die Liste der Hilfethemen, die in den Aspose.Cells-Wiki-Dokumenten hinzugefügt wurden:

1. Spalten und Zeilen automatisch anpassen, während HTML in die Arbeitsmappe geladen wird
2. Konvertieren Sie Text in Spalten mit Aspose.Cells
3. Rufen Sie eine Liste der Schriftarten ab, die in einer Tabelle oder Arbeitsmappe verwendet werden
4. Erhalten Sie Warnungen beim Laden einer Excel-Datei
5. Lesen und bearbeiten Sie Excel 2016-Diagramme
6. Trimmen Sie führende leere Zeilen und Spalten beim Exportieren von Tabellenkalkulationen in das Format CSV
7. Binden des Arbeitsblatts an ein benutzerdefiniertes Sammlungsobjekt mithilfe von GridWeb
8. Benennen Sie doppelte Spalten beim Exportieren von Arbeitsblattdaten automatisch um
9. Geteilte Fenster im GridDesktop-Arbeitsblatt