Öffentliche API Änderungen in Aspose.Cells 9.0.0

Dieses Dokument beschreibt die Änderungen an der Aspose.Cells API von Version 8.9.2 auf 9.0.0, die für Modul-/Anwendungsentwickler von Interesse sein könnten. Es umfasst nicht nur neue und aktualisierte öffentliche Methoden, hinzugefügte und entfernte Klassen usw., sondern auch eine Beschreibung etwaiger Änderungen im Verhalten hinter den Kulissen in Aspose.Cells.

Hinzugefügte APIs

Hinzugefügte Shape.TextOptions Eigenschaft

Aspose.Cells for .NET hat die TextOptions-Eigenschaft für die Klasse Shape freigegeben, um das Erscheinungsbild textlicher Teile einer Form zu steuern.

Hier ist ein einfaches Anwendungsbeispiel der Shape.TextOptions Eigenschaft.

C#

 // Initialize an instance of Workbook

var book = new Workbook();

// Get the default Worksheet from the Workbook

var sheet = book.Worksheets[0];

// Add a TextBox to the collection

var textboxIndex = sheet.TextBoxes.Add(2, 1, 160, 200);

// Get the TextBox object

var textbox = sheet.TextBoxes[textboxIndex];

// Add text to the TextBox

textbox.Text = "Hello Aspose!";

// Format the textual contents

textbox.TextOptions.Color = System.Drawing.Color.Red;

textbox.TextOptions.IsItalic = true;

Hinzugefügte LoadOptions.CultureInfo-Eigenschaft

Aspose.Cells for .NET 9.0.0 hat die LoadOptions.CultureInfo-Eigenschaft freigegeben, die es ermöglicht, eine Instanz von CultureInfo beim Laden eines Dokuments in eine Instanz von Workbook einzuspielen.

Hier ist ein einfaches Anwendungsszenario der genannten Eigenschaften.

Weitere Informationen finden Sie im ausführlichen Artikel über das Laden von Tabellenkalkulationen mit einer spezifischen Kultur (CultureInfo).

C#

 // Create an instance of CultureInfo and populate its properties

var culture = new CultureInfo("en-GB");

culture.NumberFormat.NumberDecimalSeparator = ",";

culture.DateTimeFormat.DateSeparator = "-";

culture.DateTimeFormat.ShortDatePattern = "dd-MM-yyyy";

// Create an instance of LoadOptions and set the CultureInfo property

var options = new LoadOptions(LoadFormat.Html);

options.CultureInfo = culture;

// Load a HTML or TXT file in an instance of Workbook with instance of  LoadOptions

var book = new Workbook(dir + "input.html", options);

Hinzugefügte ChartPoint.IsInSecondaryPlot Eigenschaft

Aspose.Cells for .NET hat die ChartPoint.IsInSecondaryPlot-Eigenschaft freigegeben, die verwendet werden kann, um festzustellen, ob sich ein ChartPoint auf einem sekundären Diagramm einer Torten- oder Balkendiagramm befindet.

Hier ist ein einfaches Anwendungsbeispiel der Shape.Line Eigenschaft.

Lesen Sie den detaillierten Artikel zum Thema Ermitteln eines Datenpunkts auf dem zweiten Diagramm.

C#

 // Load an existing spreadsheet containing a Pie chart

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

// Load the Worksheet at 0 index

var sheet = book.Worksheets[0];

// Load the first chart from the collection

var chart = sheet.Charts[0];

// Calculate the chart before accessing its properties

chart.Calculate();

// Accessing chart's first series

var series = chart.NSeries[0];

// Loop over the ChartPoint collection

foreach (ChartPoint point in series.Points)

{

    // Detect if ChartPoint resides on secondary plot

    Console.WriteLine(point.IsInSecondaryPlot);

}

Hinzugefügte OleObject.ClassIdentifier Eigenschaft

Aspose.Cells for .NET 9.0.0 hat die Eigenschaft OleObject.ClassIdentifier freigelegt, die verwendet werden kann, um das Anwendungsverhalten zum Laden eines OleObjects festzulegen. Beispielsweise kann eine PPT-Datei in einer Arbeitsmappe mit 2 verschiedenen Ansichten eingebettet werden, nämlich Präsentationsansicht oder Foliensicht, wobei beide Ansichten unterschiedliche Klassifiziererwerte haben.

Im Folgenden finden Sie das einfache Anwendungsszenario der OleObject.ClassIdentifier Eigenschaft.

Lesen Sie den detaillierten Artikel zur Verwendung von OleObject.ClassIdentifier.

C#

 // Load a spreadsheet containing a presentation as OleObject

var book = new Workbook(dir + "embeddedPresentation.xls");

// Initialize variables to store properties of OleObject

int upperLeftRow = 0;

int upperLeftColumn = 0;

int height = 0;

int width = 0;

byte[] imageData = null;

int x = 0;

int y = 0;

byte[] objData = null;

string progID = "";

FileFormatType fileFormatType = FileFormatType.Unknown;

string sourceFullName = "";

bool isDisplayAsIcon = false;

byte[] classId = null;

// Get the first worksheet from the collection

var sheet = book.Worksheets[0];

// Get the first OleObject from the collection

var frame = sheet.OleObjects[0];

// Store the properties in variables

upperLeftRow = frame.UpperLeftRow;

upperLeftColumn = frame.UpperLeftColumn;

height = frame.Height;

width = frame.Width;

imageData = frame.ImageData;

x = frame.X;

y = frame.Y;

objData = frame.ObjectData;

progID = frame.ProgID;

fileFormatType = frame.FileFormatType;

sourceFullName = frame.ObjectSourceFullName;

isDisplayAsIcon = frame.DisplayAsIcon;

classId = frame.ClassIdentifier;

// Initialize a new Workbook instance

book = new Workbook();

// Access first worksheet from the collection

sheet = book.Worksheets[0];

// Insert the OleObject to the worksheet

int oleNumber = sheet.OleObjects.Add(upperLeftRow, upperLeftColumn, height, width, imageData);

// Access newly inserted OleObject

var embeddedObject = sheet.OleObjects[oleNumber];

// Assign previously stored properties to new OleObject

embeddedObject.X = x;

embeddedObject.Y = y;

embeddedObject.ObjectData = objData;

embeddedObject.ProgID = progID;

embeddedObject.FileFormatType = fileFormatType;

embeddedObject.DisplayAsIcon = isDisplayAsIcon;

embeddedObject.ObjectSourceFullName = sourceFullName;

embeddedObject.IsAutoSize = false;

if (classId != null)

{

    embeddedObject.ClassIdentifier = classId;

}

// Save the resultant spreadsheet

book.Save(dir  + "output.xls");

Veraltete APIs

Veraltete Worksheet.SetBackground Methode

Bitte verwenden Sie stattdessen die Worksheet.BackgroundImage Eigenschaft.

Veraltete LineShape.BeginArrowheadStyle & ArcShape.BeginArrowheadStyle Eigenschaften

Bitte verwenden Sie die Shape.Line.BeginArrowheadStyle Eigenschaft als Alternative.

Veraltete LineShape.EndArrowheadStyle & ArcShape.EndArrowheadStyle Eigenschaften

Bitte verwenden Sie die Shape.Line.EndArrowheadStyle Eigenschaft als Alternative.

Veraltete LineShape.BeginArrowheadWidth & ArcShape.BeginArrowheadWidth Eigenschaften

Bitte verwenden Sie die Shape.Line.BeginArrowheadWidth Eigenschaft als Alternative.

Veraltete LineShape.BeginArrowheadLength & ArcShape.BeginArrowheadLength Eigenschaften

Bitte verwenden Sie stattdessen die Shape.Line.BeginArrowheadLength Eigenschaft.

Veraltete LineShape.EndArrowheadWidth & ArcShape.EndArrowheadWidth Eigenschaften

Bitte verwenden Sie stattdessen die Shape.Line.EndArrowheadWidth Eigenschaft.

Veraltete LineShape.EndArrowheadLength & ArcShape.EndArrowheadLength Eigenschaften

Bitte verwenden Sie stattdessen die Shape.Line.EndArrowheadLength Eigenschaft.

Gelöschte APIs

Gelöschte Worksheet.CopyConditionalFormatting Methode

Gelöschte Workbook.CheckWriteProtectedPassword Methode

Umbenannte APIs

Umbenannte Workbook.RemoveDigitallySign Methode

Die Workbook.RemoveDigitallySign Methode wurde in Workbook.RemoveDigitalSignature umbenannt.