Modifiche all API pubblica in Aspose.Cells 8.9.0

Questo documento descrive le modifiche all’API Aspose.Cells dalla versione 8.8.3 alla 8.9.0 che potrebbero interessare agli sviluppatori di moduli/applicazioni. Include non solo nuovi metodi pubblici e aggiornati, classi aggiunte e rimosse, ma anche una descrizione di eventuali modifiche nel comportamento interno di Aspose.Cells.

API aggiunte

Aggiunta la proprietà HtmlSaveOptions.DefaultFontName

Aspose.Cells for .NET 8.9.0 ha esposto la proprietà DefaultFontName per la classe HtmlSaveOptions che consente di specificare il nome del carattere predefinito durante il rendering dei fogli di calcolo nel formato HTML. Il carattere predefinito verrà utilizzato solo quando il carattere dello stile non esiste. Il valore predefinito della proprietà HtmlSaveOptions.DefaultFontName è null, il che significa che API Aspose.Cells for .NET utilizzerà il carattere universale che ha la stessa famiglia del carattere originale.

Per maggiori dettagli su questa funzionalità, si prega di consultare l’articolo su Impostazione del carattere predefinito per il rendering dei fogli di calcolo nel formato HTML.

Di seguito è riportato il semplice scenario d’uso.

C#

 // Create an instance of HtmlSaveOptions

var options = new HtmlSaveOptions();

// Set default font name for Html rendering

options.DefaultFontName = "Arial";

// Load a spreadsheet in an instance of Workbook

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

// Save the spreadsheet in Html format while passing instance of HtmlSaveOptions

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

Aggiunta la proprietà ImageOrPrintOptions.DefaultFont

Aspose.Cells for .NET 8.9.0 consente di impostare il nome del carattere predefinito per la classe ImageOrPrintOptions esponendo la proprietà DefaultFont. La suddetta proprietà può essere utilizzata quando i caratteri Unicode nel foglio di calcolo non sono impostati con il corretto carattere nello stile della cella, pertanto tali caratteri potrebbero apparire come blocchi nelle immagini resultant.

Impostare la proprietà DefaultFont su MingLiu o MS Gothic per visualizzare i caratteri Unicode. Se la suddetta proprietà non è impostata, Aspose.Cells utilizzerà il carattere predefinito del sistema per mostrare i caratteri Unicode.

Per maggiori dettagli su questa funzionalità, si prega di consultare l’articolo su Impostazione del carattere predefinito per il rendering dei fogli di calcolo in formati di immagine.

Di seguito è riportato il semplice scenario d’uso.

C#

 // Create an instance of ImageOrPrintOptions

var options = new ImageOrPrintOptions();

// Set default font name for image rendering

options.DefaultFont = "Arial";

// Load a spreadsheet in an instance of Workbook

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

// Access the worksheet to be rendered

var sheet = book.Worksheets[0];

// Create an instance of SheetRender

var render = new SheetRender(sheet, options);

// Save spreadsheet to image

render.ToImage(0, dir + "output.png");

Aggiunta la proprietà PivotTable.IsExcel2003Compatible

Aspose.Cells for .NET API ha esposto la proprietà di tipo Boolean IsExcel2003Compatible per la classe PivotTable che consente di specificare se la PivotTable è compatibile con Excel 2003 ai fini dell’aggiornamento. Il valore predefinito della proprietà IsExcel2003Compatible è true, il che significa che una stringa deve essere minore o uguale a 255 caratteri. Se la stringa è maggiore di 255 caratteri, verrà troncata. Se è false, la suddetta restrizione non verrà imposta.

Per maggiori dettagli su questa funzionalità, si prega di consultare l’articolo su Compatibilità per Excel 2003 per l’aggiornamento delle tabelle pivot.

Di seguito è riportato il semplice scenario d’uso.

C#

 // Load a spreadsheet in an instance of Workbook

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

// Access the desired Pivot Table from the spreadsheet

var pivot = book.Worksheets[0].PivotTables[0];

// Set Excel 2003 compatibility to false

pivot.IsExcel2003Compatible = false;

// Refresh & recalculate Pivot Table

pivot.RefreshData();

pivot.CalculateData();

Aggiunto il Metodo GridWeb.GetVersion

Aspose.Cells.GridWeb per .NET 8.9.0 ha esposto il metodo factory {GetVersion}} che restituisce la versione di rilascio del componente GridWeb.