Pubblico API Modifiche in Aspose.Cells 9.0.0

Questo documento descrive le modifiche allo Aspose.Cells API dalla versione 8.9.2 alla 9.0.0 che potrebbero interessare gli sviluppatori di moduli/applicazioni. Include non solo metodi pubblici nuovi e aggiornati, classi aggiunte e rimosse ecc., ma anche una descrizione di eventuali cambiamenti nel comportamento dietro le quinte in Aspose.Cells.

API aggiunte

Proprietà Shape.TextOptions aggiunta

Aspose.Cells for .NET ha esposto la proprietà TextOptions per la classe Shape per controllare l’aspetto delle parti testuali di una Shape.

Ecco un semplice scenario di utilizzo della proprietà Shape.TextOptions.

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;

Aggiunta proprietà LoadOptions.CultureInfo

Aspose.Cells for .NET 9.0.0 ha esposto la proprietà LoadOptions.CultureInfo che consente di iniettare un’istanza di CultureInfo al momento del caricamento di un documento in un’istanza di Workbook.

Ecco un semplice scenario di utilizzo delle proprietà di cui sopra.

Controlla l’articolo dettagliato suCaricamento foglio di calcolo con CultureInfo specifiche.

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

Proprietà ChartPoint.IsInSecondaryPlot aggiunta

Aspose.Cells for .NET ha esposto la proprietà ChartPoint.IsInSecondaryPlot che può essere utilizzata per rilevare se un ChartPoint si trova su un grafico secondario di un grafico a torta oa barre.

Ecco un semplice scenario di utilizzo della proprietà Shape.Line.

Controlla l’articolo dettagliato suLa ricerca di un punto dati risiede nel secondo grafico.

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

}

Aggiunta proprietà OleObject.ClassIdentifier

Aspose.Cells for .NET 9.0.0 ha esposto la proprietà OleObject.ClassIdentifier che può essere utilizzata per specificare il comportamento dell’applicazione per caricare un OleObject. Ad esempio, un file PPT può essere incorporato in un foglio di calcolo con 2 viste diverse, ovvero; vista presentazione o vista diapositiva, mentre entrambe le viste hanno valori di identificatore di classe diversi.

Di seguito è riportato il semplice scenario di utilizzo della proprietà OleObject.ClassIdentifier.

Controlla l’articolo dettagliato suUtilizzo di 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");

API obsolete

Metodo Worksheet.SetBackground obsoleto

Utilizzare invece la proprietà Worksheet.BackgroundImage.

Proprietà LineShape.BeginArrowheadStyle e ArcShape.BeginArrowheadStyle obsolete

Utilizzare la proprietà Shape.Line.BeginArrowheadStyle come alternativa.

Proprietà LineShape.EndArrowheadStyle e ArcShape.EndArrowheadStyle obsolete

Utilizzare la proprietà Shape.Line.EndArrowheadStyle come alternativa.

Proprietà LineShape.BeginArrowheadWidth e ArcShape.BeginArrowheadWidth obsolete

Utilizzare la proprietà Shape.Line.BeginArrowheadWidth come alternativa.

Proprietà LineShape.BeginArrowheadLength e ArcShape.BeginArrowheadLength obsolete

Utilizzare invece la proprietà Shape.Line.BeginArrowheadLength.

Proprietà LineShape.EndArrowheadWidth e ArcShape.EndArrowheadWidth obsolete

Utilizzare invece la proprietà Shape.Line.EndArrowheadWidth.

Proprietà LineShape.EndArrowheadLength e ArcShape.EndArrowheadLength obsolete

Utilizzare invece la proprietà Shape.Line.EndArrowheadLength.

API eliminate

Metodo Worksheet.CopyConditionalFormatting eliminato

Metodo Workbook.CheckWriteProtectedPassword eliminato

API rinominate

Metodo Workbook.RemoveDigitallySign rinominato

Il metodo Workbook.RemoveDigitallySign è stato rinominato in Workbook.RemoveDigitalSignature.