Público API Cambios en Aspose.Cells 9.0.0

Este documento describe los cambios al Aspose.Cells API de la versión 8.9.2 a la 9.0.0 que pueden ser de interés para los desarrolladores de módulos/aplicaciones. Incluye no solo métodos públicos nuevos y actualizados, clases agregadas y eliminadas, etc., sino también una descripción de cualquier cambio en el comportamiento detrás de escena en Aspose.Cells.

API añadidas

Se agregó la propiedad Shape.TextOptions

Aspose.Cells for .NET ha expuesto la propiedad TextOptions para la clase Shape para controlar la apariencia de las partes textuales de una forma.

Aquí hay un escenario de uso simple de la propiedad Shape.TextOptions.

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

Se agregó la propiedad LoadOptions.CultureInfo

Aspose.Cells for .NET 9.0.0 ha expuesto la propiedad LoadOptions.CultureInfo que permite inyectar una instancia de CultureInfo al momento de cargar un documento en una instancia de Workbook.

Aquí hay un escenario de uso simple de las propiedades antes mencionadas.

Consulte el artículo detallado sobreCargando hoja de cálculo con información cultural específica.

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

Se agregó la propiedad ChartPoint.IsInSecondaryPlot

Aspose.Cells for .NET ha expuesto la propiedad ChartPoint.IsInSecondaryPlot que se puede usar para detectar si un ChartPoint reside en un gráfico secundario de un gráfico circular o de barras.

Aquí hay un escenario de uso simple de la propiedad Shape.Line.

Consulte el artículo detallado sobreEncontrar un punto de datos reside en la segunda parcela.

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

}

Se agregó la propiedad OleObject.ClassIdentifier

Aspose.Cells for .NET 9.0.0 ha expuesto la propiedad OleObject.ClassIdentifier que se puede usar para especificar el comportamiento de la aplicación para cargar un OleObject. Por ejemplo, un archivo PPT se puede incrustar en una hoja de cálculo con 2 vistas diferentes, es decir; vista de presentación o vista de diapositivas, mientras que ambas vistas tienen diferentes valores de identificador de clase.

El siguiente es el escenario de uso simple de la propiedad OleObject.ClassIdentifier.

Consulte el artículo detallado sobreUso de OleObject.ClassIdentifier.

 // 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 obsoletas

Método Worksheet.SetBackground obsoleto

Utilice la propiedad Worksheet.BackgroundImage en su lugar.

Propiedades LineShape.BeginArrowheadStyle y ArcShape.BeginArrowheadStyle obsoletas

Utilice la propiedad Shape.Line.BeginArrowheadStyle como alternativa.

Propiedades LineShape.EndArrowheadStyle y ArcShape.EndArrowheadStyle obsoletas

Utilice la propiedad Shape.Line.EndArrowheadStyle como alternativa.

Propiedades LineShape.BeginArrowheadWidth y ArcShape.BeginArrowheadWidth obsoletas

Utilice la propiedad Shape.Line.BeginArrowheadWidth como alternativa.

Propiedades LineShape.BeginArrowheadLength y ArcShape.BeginArrowheadLength obsoletas

Utilice la propiedad Shape.Line.BeginArrowheadLength en su lugar.

Propiedades LineShape.EndArrowheadWidth y ArcShape.EndArrowheadWidth obsoletas

Utilice la propiedad Shape.Line.EndArrowheadWidth en su lugar.

Propiedades LineShape.EndArrowheadLength y ArcShape.EndArrowheadLength obsoletas

Utilice la propiedad Shape.Line.EndArrowheadLength en su lugar.

API eliminadas

Hoja de trabajo eliminada. Método de formato de copia condicional

Libro de trabajo eliminado. Método CheckWriteProtectedPassword

API renombradas

Método Renombrado Workbook.RemoveDigitallySign

Se cambió el nombre del método Workbook.RemoveDigitallySign a Workbook.RemoveDigitalSignature.

Público API Cambios en Aspose.Cells 8.9.2 Público API Cambios en Aspose.Cells 16.10.0