Aspose.Cells for .NET 17.02.0 Notas de la versión

Public API y cambios incompatibles con versiones anteriores

La siguiente es una lista de los cambios realizados al público API, como miembros agregados, renombrados, eliminados o obsoletos, así como cualquier cambio no compatible con versiones anteriores realizado en Aspose.Cells for .NET. Si tiene inquietudes sobre cualquier cambio enumerado, plantéelo en el foro de soporte Aspose.Cells.

Se agregó la propiedad HTMLLoadOptions.AutoFitColsAndRows

Esta versión de Aspose.Cells for .NET API ha agregado la propiedad HTMLLoadOptions.AutoFitColsAndRows que indica si API debe ajustarse automáticamente a columnas y filas al importar HTML en su modo de objeto. La propiedad de tipo booleano tiene el valor predeterminado como falso, lo que significa que los altos y anchos de las celdas se importarán tal como están; sin embargo, cuando la propiedad mencionada anteriormente se establece en verdadero, el API intenta ajustar los anchos de las columnas y los altos de las filas de acuerdo con el contenido. .

Este es el escenario de uso simple de la propiedad HTMLLoadOptions.AutoFitColsAndRows.

 // Create an instance of HTMLLoadOptions

var loadOptions = new HTMLLoadOptions();

// Set the AutoFitColsAndRows property to true

loadOptions.AutoFitColsAndRows = true;

// Create an instance of Workbook and load HTML while passing

// the object of HTMLLoadOptions class created above

var book = new Workbook(dir + "sample.htm", loadOptions);

Se agregaron LoadOptions.WarningCallback y WorkbookSettings.WarningCallback Propiedades

Aspose.Cells for .NET 17.02.0 ha expuesto la propiedad WarningCallback a las clases LoadOptions y WorkbookSettings para obtener o establecer la devolución de llamada de advertencia. Los desarrolladores deben implementar la interfaz IWarningCallback para obtener advertencias personalizadas en sus aplicaciones.

Aquí hay un escenario de uso simple de la propiedad LoadOptions.WarningCallback para recibir advertencias cuando una hoja de cálculo de entrada contiene rangos con nombre duplicados.

 public class WarningCallback : IWarningCallback

{

    public void Warning(WarningInfo warningInfo)

    {

        if (warningInfo.WarningType == WarningType.DuplicateDefinedName)

        {

            Console.WriteLine("Duplicate Defined Names Found as " + warningInfo.Description);

        }

    }

}

Aquí se explica cómo utilizar la clase personalizada definida anteriormente.

 // Create an instance of LoadOptions class

var options = new LoadOptions();

// Set the WarningCallback property to custom class

options.WarningCallback = new WarningCallback();

// Load a sample spreadsheet in an instance of Workbook while 

// passing the object of LoadOptions class as defined above

var book = new Workbook(dir + "sample.xlsx", options);

Agregado Cells. Método TextToColumns

La última revisión de las API Aspose.Cells for .NET ha expuesto el método Cells.TextToColumns para imitar el de ExcelTexto a columnas rasgo. Excel proporciona esta función desdeHerramientas de datos bajo laDatospestaña. Tenga en cuenta que, para dividir el contenido de una columna en varias columnas, los datos deben contener un delimitador específico, como una coma (o cualquier otro carácter), según el cual el API intenta dividir el contenido de una celda en varias celdas.

Aquí hay un escenario de uso simple para demostrar el uso de API recién expuesto.

 // Create an instance of Workbook and load a sample

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

// Retrieve the cells collection of the first worksheet in the sample

var cells = book.Worksheets[0].Cells;

// Create an instance of TxtLoadOptions

var options = new TxtLoadOptions();

// Specify the separator

options.Separator = ',';

// Split the data in range B2:B4

cells.TextToColumns(1, 1, 3, options);

Método Workbook.GetFonts agregado

Aspose.Cells for .NET 17.02.0 ha expuesto el método GetFonts para la clase Workbook. El método Workbook.GetFonts devuelve la lista de fuentes individuales utilizadas para formatear el contenido de las celdas de una hoja de cálculo determinada. El tipo de retorno del método mencionado anteriormente es una matriz de tipo Aspose.Cells. Clase de fuente.

El siguiente fragmento de código demuestra el uso del método Workbook.GetFonts.

 // Create an instance of Workbook and load a sample

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

// Retrieve the list of fonts used in spreadsheet

var fonts = book.GetFonts();

// Iterate the list and write font name

foreach (Aspose.Cells.Font font in fonts)

{

    Console.WriteLine(font.Name);

}

Se agregó la propiedad TxtSaveOptions.TrimLeadingBlankRowAndColumn

Esta revisión de Aspose.Cells for .NET ha expuesto la propiedad de tipo booleano TrimLeadingBlankRowAndColumn para la clase TxtSaveOptions que indica si las filas y columnas en blanco iniciales deben recortarse como lo hace Excel al exportar datos a CSV o formatos delimitados por tabulaciones. El valor predeterminado de la propiedad mencionada anteriormente es falso. En caso de que los datos en la hoja de trabajo no comiencen desde la primera celda, es decir: A1, la aplicación de Excel elimina las filas y columnas en blanco iniciales mientras exporta los datos a CSV o formatos delimitados por tabuladores; sin embargo, las API Aspose.Cells de manera predeterminada, retienen las filas y columnas en blanco para la misma muestra para mantener la ubicación de los datos si los archivos CSV o delimitados por tabulaciones exportados tienen que volver a importarse utilizando las API Aspose.Cells.

Aquí hay un escenario de uso simple de la propiedad TrimLeadingBlankRowAndColumn.

 // Create an instance of Workbook and load a sample

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

// Create an instance of TxtSaveOptions

var options = new TxtSaveOptions();

// Set TrimLeadingBlankRowAndColumn property to true

options.TrimLeadingBlankRowAndColumn = true;

// Export to CSV format while removing the leading blank rows & columns

book.Save(dir + "output.csv", options);

Se agregó la propiedad BuiltInDocumentPropertyCollection.Revision y la propiedad Obsoleta BuiltInDocumentPropertyCollection.RevisionNumber

Utilice la propiedad BuiltInDocumentPropertyCollection.Revision en su lugar.

Se agregó la propiedad Shape.TextShapeType

La propiedad Shape.TextShapeType obtiene o establece el tipo de forma de texto preestablecido de una lista de tipos predefinidos almacenados en la enumeración AutoShapeType.

Se agregaron la propiedad ExportTableOptions.RenameStrategy y la enumeración RenameStrategy

Aspose.Cells for .NET 17.02.0 ha expuesto la propiedad ExportTableOptions.RenameStrategy junto con la enumeración RenameStrategy para tratar el escenario donde la primera fila de datos que se exportará contiene entradas duplicadas. Si la propiedad ExportTableOptions.ExportColumnName se establece en verdadero, API generará una excepción que indica que un DataTable no puede tener columnas con los mismos nombres. Con los nuevos cambios implementados, el API permite agregar dígitos o letras a los nombres de las columnas duplicadas, mientras que el valor apropiado de la enumeración RenameStrategy decide cómo cambiar el nombre de las columnas duplicadas.

Aquí hay un escenario de uso simple que demuestra las API recientemente expuestas.

 // Create an instance of Workbook

var book = new Workbook();

// Retrieve the cells collection of first worksheet

var cells = book.Worksheets[0].Cells;

// Insert similar values in first row

// These values will serve as column names while exporting to DataTable

cells["A1"].PutValue("Column A");

cells["B1"].PutValue("Column A");

cells["C1"].PutValue("Column A");

// Insert some more data that will serve as first row of DataTable

cells["A2"].PutValue("Value 1");

cells["B2"].PutValue("Value 2");

cells["C2"].PutValue("Value 3");

// Create an instance of ExportTableOptions

var options = new ExportTableOptions();

// Set ExportColumnName property to true so that the 

// first row of worksheet data becomes the columns names of DataTable

options.ExportColumnName = true;

// Set the renaming strategy to Letter, 

// indicating the the API will append letters to duplicate column names

options.RenameStrategy = RenameStrategy.Letter;

// Export the data to DataTable while using the object of ExportTableOptions class

var table = cells.ExportDataTable(0, 0, 2, 3, options);

Se agregaron los métodos GridDesktop.DoSplit y GridDesktop.UnDoSplit

Aspose.Cells.GridDesktop for .NET 17.02.0 ha proporcionado dos nuevos métodos que podrían dividir el contenido de la hoja de trabajo en paneles o fusionar los paneles existentes.

Ejemplos de uso

Consulte la lista de temas de ayuda agregados en los documentos Wiki Aspose.Cells:

1. Autoajustar columnas y filas al cargar HTML en el libro de trabajo
2. Convertir Texto a Columnas usando Aspose.Cells
3. Obtenga una lista de fuentes utilizadas en una hoja de cálculo o libro de trabajo
4. Recibe advertencias al cargar un archivo de Excel
5. Leer y manipular gráficos de Excel 2016
6. Recorte las filas y columnas en blanco iniciales al exportar hojas de cálculo al formato CSV
7. Vinculación de una hoja de trabajo a un objeto de colección personalizado mediante GridWeb
8. Cambie el nombre de las columnas duplicadas automáticamente al exportar datos de la hoja de trabajo
9. Dividir paneles en la hoja de trabajo de GridDesktop