Öffentlich API Änderungen in Aspose.Cells 8.3.2

Dieses Dokument beschreibt die Änderungen an Aspose.Cells API von Version 8.3.1 zu 8.3.2, die für Modul-/Anwendungsentwickler von Interesse sein könnten. Es enthält nicht nur neue und aktualisierte öffentliche Methoden,zusätzliche Klassen usw. undKlassen entfernt usw., sondern auch eine Beschreibung etwaiger Verhaltensänderungen hinter den Kulissen in Aspose.Cells.

APIs hinzugefügt

Mechanismus zum Festlegen der absoluten Position von PivotItem

Um die Funktion bereitzustellenAbsolute Positionierung des PivotItemsAspose.Cells for .NET 8.3.2 hat eine Reihe von Eigenschaften und hilfreichen Methoden bereitgestellt, wie unten aufgeführt.

Die PivotItem.Position-Eigenschaft kann verwendet werden, um den Positionsindex in allen PivotItems unabhängig vom übergeordneten Knoten anzugeben.
Die PivotItem.PositionInSameParentNode-Eigenschaft kann verwendet werden, um den Positionsindex in den PivotItems unter demselben übergeordneten Knoten anzugeben.
Die PivotItem.Move(int count, bool isSameParent)-Methode kann verwendet werden, um das Element basierend auf dem count-Wert nach oben oder unten zu verschieben, wobei count die Nummer der Position ist, um das PivotItem nach oben oder unten zu verschieben. Wenn der Zählwert kleiner als null ist, wird das Element nach oben verschoben, während das PivotItem nach unten verschoben wird, wenn der Zählwert größer als null ist. Der isSameParent-Parameter vom booleschen Typ gibt an, ob der Verschiebevorgang im selben übergeordneten Knoten ausgeführt werden muss oder nicht.

Bitte beachten Sie, dass die Methoden PivotTable.RefreshData und PivotTable.CalculateData aufgerufen werden müssen, bevor die Eigenschaften PivotItem.Position, PivotItem.PositionInSameParentNode und die Methode PivotItem.Move(int count, bool isSameParent) verwendet werden.

Klasse SignatureLine hinzugefügt

Aspose.Cells for .NET 8.3.2 bietet Unterstützung für die Signaturzeile, um die entsprechende Funktion von MS Excel nachzuahmen. Diese Version von Aspose.Cells for .NET hat die SignatureLine-Klasse und die Picture.SignatureLine-Eigenschaft für diesen Zweck verfügbar gemacht.

Der folgende Beispielcode fügt der Arbeitsmappe eine Signaturzeile mit der Picture.SignatureLine-Eigenschaft hinzu.

 //Create workbook object

Workbook workbook = new Workbook();

//Insert picture of your choice

int index = workbook.Worksheets[0].Pictures.Add(0, 0, "signature.jpg");

//Access picture and add signature line inside it

Picture pic = workbook.Worksheets[0].Pictures[index];

//Create signature line object

SignatureLine s = new SignatureLine();

s.Signer = "John Doe";

s.Title = "Development Lead";

s.Email = "john.doe@aspose.com";

//Assign the signature line object to Picture.SignatureLine property

pic.SignatureLine = s;

Methode Chart.HasAxis Hinzugefügt

Mit der Veröffentlichung von v8.3.2 hat der Aspose.Cells API die Methode Chart.HasAxis(AxisType axisType, bool isPrimary) bereitgestellt, um zu bestimmen, ob das Diagramm eine bestimmte Achse hat oder nicht.

Der folgende Beispielcode demonstriert die Verwendung der Chart.HasAxis-Methode, um zu bestimmen, ob das Beispieldiagramm eine Primär-, Sekundär- und Wertachse hat.

 //Create workbook object

Workbook workbook = new Workbook("source.xlsx");

//Access the first worksheet

Worksheet worksheet = workbook.Worksheets[0];

//Access the chart

Chart chart = worksheet.Charts[0];

//Determine which axis exists in chart

bool ret = chart.HasAxis(AxisType.Category, true);

Console.WriteLine("Has Primary Category Axis: " + ret);

ret = chart.HasAxis(AxisType.Category, false);

Console.WriteLine("Has Secondary Category Axis: " + ret);

ret = chart.HasAxis(AxisType.Value, true);

Console.WriteLine("Has Primary Value Axis: " + ret);

ret = chart.HasAxis(AxisType.Value, false);

Console.WriteLine("Has Secondary Value Axis: " + ret);

Methode WorkbookSettings.CheckWriteProtectedPassword hinzugefügt

Die Methode WorkbookSettings.CheckWriteProtectedPassword ermöglicht es den Entwicklern zu überprüfen, ob ein gegebenes Passwort zum Ändern der Tabelle korrekt ist oder nicht.

 //Specify password to open inside the load options

LoadOptions opts = new LoadOptions();

opts.Password = "1234";

//Open the source Excel file with load options

Workbook workbook = new Workbook("Book1.xlsx", opts);

//Check if 567 is Password to modify

bool ret = workbook.CheckWriteProtectedPassword("567");

Console.WriteLine("Is 567 correct Password to modify: " + ret);

Überladungsmethoden WorkbookRender.ToPrinter & SheetRender.ToPrinter Hinzugefügt

Aspose.Cells for .NET 8.3.2 hat die Methoden WorkbookRender.ToPrinter(string PrinterName, int PrintPageIndex, int PrintPageCount) und SheetRender.ToPrinter(string PrinterName, int PrintPageIndex, int PrintPageCount) bereitgestellt, um den Seitenbereich der Arbeitsmappe bzw. des Arbeitsblatts zu drucken.

Der folgende Beispielcode veranschaulicht die Verwendung der oben genannten Methoden zum Drucken der Seiten 2-5 der Arbeitsmappe und des Arbeitsblatts.

 //Create workbook from source Excel file

Workbook workbook = new Workbook("source.xlsx");

//Print the workbook specifying the range of pages

//Here we are printing pages 2-5

WorkbookRender wr = new WorkbookRender(workbook, new ImageOrPrintOptions());

wr.ToPrinter(printerName, 1, 4);

//Access first worksheet

Worksheet worksheet = workbook.Worksheets[0];

//Print the worksheet specifying the range of pages

//Here we are printing pages 2-5

SheetRender sr = new SheetRender(worksheet, new ImageOrPrintOptions());

sr.ToPrinter(printerName, 1, 4);

Methode Worksheet.RefreshPivotTables Hinzugefügt

Die neu hinzugefügte Methode Worksheet.RefreshPivotTables ermöglicht es, alle Pivot-Tabellen in einem bestimmten Arbeitsblatt in einem einzigen Aufruf zu aktualisieren.

 worksheet.RefreshPivotTables();

Methode Workbook.GetNamedStyle hinzugefügt

Aspose.Cells for .NET API hat die Workbook.GetNamedStyle-Methode verfügbar gemacht, die die Zeichenfolge als Parameter akzeptiert und das Style-Objekt basierend auf dem übergebenen Parameter abruft.

Methode Cells.ImportTwoDimensionArray Hinzugefügt

Aspose.Cells for .NET API hat es ermöglicht, zweidimensionale Arrays in Tabellenkalkulationszellen zu importieren, indem die Methode Cells.ImportTwoDimensionArray(object[,], object[,], int, int, TxtLoadOptions) bereitgestellt wird. Die genannte Methode importiert ein zweidimensionales Array von Daten in ein Arbeitsblatt mit flexibleren Optionen, die in TxtLoadOptions definiert sind.

Eigenschaften OnePagePerSheet, PageIndex & PageCount hinzugefügt

Aspose.Cells for .NET 8.3.2 hat die OnePagePerSheet-, PageIndex- und PageCount-Eigenschaften für die XpsSaveOptions-Klasse verfügbar gemacht. Der Benutzer kann mithilfe der OnePagePerSheet-Eigenschaft den gesamten Inhalt einer Tabelle auf eine einzelne Seite von XPS packen und/oder die Anzahl der zu druckenden Seiten mithilfe der PageCount-Eigenschaft abrufen. Die PageIndex-Eigenschaft ruft/legt den 0-basierten Index der ersten zu speichernden Seite fest.

Eigenschaften NumberDecimalSeparator & NumberGroupSeparator hinzugefügt

Aspose.Cells for .NET 8.3.2 hat NumberDecimalSeparator- und NumberGroupSeparator-Eigenschaften eingeführt, mit denen die benutzerdefinierten Trennzeichen abgerufen/festgelegt werden können, die zum Formatieren und Analysieren der numerischen Werte in Tabellenkalkulationen verwendet werden.

Der folgende Beispielcode veranschaulicht, wie die benutzerdefinierten Trennzeichen mithilfe von Aspose.Cells API angegeben werden. Der folgende Code gibt die benutzerdefinierten Dezimal- und Gruppentrennzeichen als Punkt bzw. Leerzeichen an.

 Workbook workbook = new Workbook();

//Specify custom separators

workbook.Settings.NumberDecimalSeparator = '.';

workbook.Settings.NumberGroupSeparator = ' ';

Eigenschaft PdfSaveOptions.IsFontSubstitutionCharGranularity Hinzugefügt

Aspose.Cells for .NET 8.3.2 hat die PdfSaveOptions.IsFontSubstitutionCharGranularity-Eigenschaft verfügbar gemacht, um das Problem zu lösen, bei dem einige Unicode-Zeichen nicht mit einer bestimmten Schriftartfamilie angezeigt werden können. Wenn die PdfSaveOptions.IsFontSubstitutionCharGranularity-Eigenschaft auf „true“ gesetzt ist, wird nur die Schriftart bestimmter Zeichen, die nicht anzeigbar sind, in eine anzeigbare Schriftart geändert, und der Rest des Wortes oder Satzes sollte in der ursprünglichen Schriftart bleiben.

 //Save to Pdf after setting PdfSaveOptions.IsFontSubstitutionCharGranularity to true

PdfSaveOptions opts = new PdfSaveOptions();

opts.IsFontSubstitutionCharGranularity = true;

Entfernte APIs

Veraltete Methoden entfernt

Die folgenden Methoden wurden aus dem öffentlichen API entfernt.

Workbook.Open- und Workbook.Save-Methoden.
Workbook.SetOleSize-Methode.
Workbook.LoadData-Methode.
WorkbookDesigner.Open- und WorkbookDesigner.Save-Methoden.
WorksheetCollection.DeleteName-Methode.

Veraltete Eigenschaften entfernt

Die folgenden Eigenschaften wurden aus der öffentlichen API entfernt.

Workbook.IsProtected-Eigenschaft.
Workbook.Language-Eigenschaft.
Workbook.Region-Eigenschaft.
WorkbookSettings.ReCalcOnOpen-Eigenschaft.
WorkbookSettings.Language-Eigenschaft.
WorkbookSettings.Encoding-Eigenschaft.
WorkbookSettings.ConvertNumericData-Eigenschaft.
WorksheetCollection.HidePivotFieldList-Eigenschaft.
WorksheetCollection.EnableHTTPCompression-Eigenschaft.
WorksheetCollection.IsMinimized-Eigenschaft.
WorksheetCollection.IsHidden-Eigenschaft.
WorksheetCollection.SheetTabBarWidth-Eigenschaft.
WorksheetCollection.WindowLeft-Eigenschaft.
WorksheetCollection.WindowLeftInch-Eigenschaft.
WorksheetCollection.WindowLeftCM-Eigenschaft.
WorksheetCollection.WindowTop-Eigenschaft.
WorksheetCollection.WindowTopInch-Eigenschaft.
WorksheetCollection.WindowTopCM-Eigenschaft.
WorksheetCollection.WindowWidth-Eigenschaft.
WorksheetCollection.WindowWidthInch-Eigenschaft.
WorksheetCollection.WindowWidthCM-Eigenschaft.
WorksheetCollection.WindowHeight-Eigenschaft.
WorksheetCollection.WindowHeightInch-Eigenschaft.
WorksheetCollection.WindowHeightCM-Eigenschaft.
Worksheet.HPageBreaks-Eigenschaft.
Worksheet.VPageBreaks-Eigenschaft.
HtmlSaveOptions.DisplayHTMLCrossString-Eigenschaft.
HtmlSaveOptions.ExportChartImageFormat-Eigenschaft.
SaveOptions.ExpCellNameToXLSX-Eigenschaft.
SaveOptions.DefaultFont-Eigenschaft.
SaveOptions.Compliance-Eigenschaft.
SaveOptions.PdfBookmark-Eigenschaft.
SaveOptions.PdfImageCompression-Eigenschaft.
TxtSaveOptions.AlwaysQuoted-Eigenschaft.

Veraltete APIs

Eigenschaft Workbook.SaveOptions Veraltet

Ein Objekt von SaveOptions muss an die Workbook.Save-Methode übergeben werden, nachdem die richtigen SaveOptions-Eigenschaften festgelegt wurden.

Eigenschaft Workbook.Styles & Class StyleCollection Veraltet

Es wird empfohlen, die Workbook.CreateStyle-Methode zu verwenden, um den Stil für die Workbook-Instanz zu erstellen und zu bearbeiten, anstatt einen Style mit der StyleCollection.Add-Methode zu erstellen. Darüber hinaus kann die Workbook.GetNamedStyle(string)-Methode verwendet werden, um einen benannten Stil anstelle von StyleCollection[string] zu erhalten.

Methode PivotItem.Move(int count) Veraltet

Mit der Veröffentlichung von Aspose.Cells 8.3.2 hat API eine weitere Überladung der PivotItem.Move-Methode eingeführt, die den ganzzahligen Parameter für die Anzahl und den booleschen Parameter akzeptiert, um ein PivotItem innerhalb des übergeordneten Knotens zu verschieben.

Öffentlich API Änderungen in Aspose.Cells 8.3.1 Öffentlich API Änderungen in Aspose.Cells 8.4.0