Cambios en la API Pública en Aspose.Cells 8.8.1
APIs Añadidas
Filtrar los Datos para Cargar
Aspose.Cells for .NET 8.8.1 ha expuesto la enumeración LoadDataFilterOptions junto con la propiedad LoadOptions.LoadDataFilterOptions que se puede usar para especificar el tipo de dato que se debe cargar al construir el libro de trabajo a partir de un archivo de plantilla. Filtrar los datos cargados puede mejorar el rendimiento para fines especiales, especialmente al utilizar las APIs de LightCells.
La enumeración LoadDataFilterOptions proporciona las siguientes selecciones.
- Todo para cargar todo desde la hoja de cálculo.
- Nada para no cargar nada desde la hoja de cálculo.
- CellBlank carga las celdas cuyos valores están en blanco.
- CellBool carga celdas cuyos valores son booleanos.
- CellData carga datos de las celdas incluyendo valores, fórmulas y formato.
- CellError carga celdas cuyos valores son errores.
- CellNumeric carga celdas cuyos valores son numéricos (incluyendo Fecha y Hora).
- CellString carga celdas cuyos valores son texto/cadena.
- CellValue carga solo valores de celda (todos los tipos).
- Chart carga solo gráficos.
- ConditionalFormatting carga solo reglas de formato condicional.
- DataValidation carga solo reglas de validación de datos.
- DocumentProperties carga solo propiedades de documento.
- Formula carga fórmulas incluyendo nombres definidos.
- MergedArea carga solo celdas combinadas.
- PivotTable carga Tablas Dinámicas.
- Settings carga solo configuraciones de libro y hoja de cálculo.
- Shape carga solo formas.
- Style carga formato de celdas.
- Table carga tablas de Excel/Objetos de Lista.
A continuación se muestra un escenario de uso simple.
C#
//Create an instance of LoadOptions & initialize it with type of template to be loaded
var options = new LoadOptions(LoadFormat.Xlsx);
//Set LoadDataFilterOptions to load only shapes
options.LoadDataFilterOptions = LoadDataFilterOptions.Shape;
//Create an instance of Workbook from a existing spreadsheet using instance of LoadOptions
var book = new Workbook(filePath, options);
Convertir directamente el gráfico a PDF
Las APIs de Aspose.Cells ya han proporcionado la facilidad de renderizar gráficos a PDF utilizando el método Chart.ToPdf. Con esta versión, la API ha expuesto otra versión sobrecargada de dicho método que puede aceptar una instancia de Stream, permitiendo a los usuarios guardar el PDF del gráfico en una instancia de MemoryStream.
A continuación se muestra un escenario de uso simple.
C#
//Create an instance of Workbook and load an existing spreadsheet with a chart
var workbook = new Workbook(filePath);
//Access first worksheet containing a chart
var worksheet = workbook.Worksheets[0];
//Access first chart from the worksheet
var chart = worksheet.Charts[0];
//Save the chart to PDF as Stream
using (MemoryStream stream = new MemoryStream())
{
chart.ToPdf(stream);
}
Añadida la propiedad WorkbookSettings.PaperSize
Aspose.Cells for .NET 8.8.1 ha expuesto la propiedad WorkbookSettings.PaperSize para establecer el tamaño de papel de impresión predeterminado para toda la hoja de cálculo. La propiedad WorkbookSettings.PaperSize acepta un valor de la enumeración PaperSizeType que contiene los tamaños predefinidos para los tipos de papel de impresión más utilizados.
C#
//Create an instance of Workbook
//Optionally load an existing spreadsheet
var book = new Workbook();
//Access WorkbookSettings from the Workbook
var settings = book.Settings;
//Set the default printing paper size for the Workbook
settings.PaperSize = PaperSizeType.PaperA4;
Añadida la propiedad Shape.TextBody
Esta versión de la API Aspose.Cells for .NET ha expuesto la propiedad Shape.TextBody para manipular los aspectos del texto en formas. El siguiente fragmento de código utiliza dicha propiedad para establecer el efecto de sombra en el texto en un cuadro de texto.
C#
//Create an instance of Workbook
var book = new Workbook();
//Access first worksheet of the Workbook
var sheet = book.Worksheets[0];
//Add a TextBox to the ShapeCollection
var textBox = sheet.Shapes.AddTextBox(2, 0, 2, 0, 100, 400);
//Set the text of the TextBox
textBox.Text = "This text has the following settings.\n\nText Effects > Shadow > Offset Bottom";
//Set shadow effect for text
for (int i = 0; i < textBox.TextBody.Count; i++)
{
textBox.TextBody[i].ShapeFont.FillFormat.ShadowEffect.PresetType = PresetShadowType.OffsetBottom;
}
Agregado el método Worksheet.CalculateFormula(string formula, CalculationOptions opts)
Aspose.Cells for .NET 8.8.1 ha expuesto otra sobrecarga para el método CalculateFormula que proporciona la capacidad de calcular una fórmula dada directamente con opciones personalizadas.
Agregado el método GridCell.CreateValidation
Aspose.Cells.GridWeb ha proporcionado la capacidad de agregar directamente la regla de validación a una celda individual mediante el método GridCell.CreateValidation. Dicho método requiere 2 parámetros. El primero es de tipo GridValidationType que determina el tipo de validación, mientras que el segundo parámetro (isRequired) es de tipo Booleano.
C#
//Access first worksheet
GridWorksheet sheet = GridWeb1.WorkSheets[0];
//Access cell B3
GridCell cell = sheet.Cells["B3"];
//Add validation inside the GridCell
//Any value which is not between 20 and 40 will cause error in a GridCell
GridValidation val = cell.CreateValidation(GridValidationType.WholeNumber, true);
val.Formula1 = "=20";
val.Formula2 = "=40";
val.Operator = GridOperatorType.Between;
val.ShowError = true;
val.ShowInput = true;
Agregado el método GridCell.RemoveValidation
Aspose.Cells.GridWeb también ha proporcionado la capacidad de eliminar la regla de validación de datos de una GridCell mediante el método GridCell.RemoveValidation.
APIs obsoletas
Propiedad Shape.TextFrame obsoleta
Se recomienda utilizar la propiedad Shape.TextBody.TextAlignment en su lugar.