Pubblico API Modifiche Aspose.Cells 8.5.0

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

API aggiunte

Modificati i parametri ICustomFunction.CalculateCustomFunction

Se un parametro per la funzione personalizzata è il riferimento di cella, nella vecchia versione Aspose.Cells le API utilizzavano per convertire il riferimento di cella in un valore di cella o in un array di oggetti di tutti i valori di cella nell’area di riferimento. Tuttavia, per molte funzioni e utenti non è richiesto l’array dei valori di cella per tutte le celle nell’area di riferimento, hanno solo bisogno di una singola cella corrispondente alla posizione della formula, oppure hanno solo bisogno del riferimento stesso invece del valore della cella o dell’array di valori . Per alcune situazioni, il recupero di tutti i valori delle celle ha persino aumentato il rischio di errore di riferimento circolare.

Per supportare questo tipo di requisito, Aspose.Cells for .NET 8.5.0 ha modificato il valore del parametro in “paramsList” per l’area di riferimento. A partire dalla versione 8.5.0, API inserisce semplicemente l’oggetto ReferredArea in “paramsList” quando il parametro corrispondente è un riferimento o il suo risultato calcolato è un riferimento. Se hai bisogno del riferimento stesso, puoi utilizzare direttamente la ReferredArea. Se è necessario ottenere un singolo valore di cella dal riferimento corrispondente alla posizione della formula, è possibile utilizzare il metodo ReferredArea.GetValue(rowOffset, int colOffset). Se hai bisogno di un array di valori di cella per l’intera area, puoi utilizzare il metodo ReferredArea.GetValues.

Ora che Aspose.Cells for .NET 8.5.0 fornisce la ReferredArea in “paramsList”, la ReferredAreaCollection in “contextObjects” non sarà più necessaria (nelle vecchie versioni non poteva sempre fornire una mappa uno-a-uno ai parametri della funzione personalizzata), quindi questa versione l’ha rimossa anche da “contextObjects” ora.

Questa modifica richiede alcune modifiche al codice dell’implementazione per ICustomFunction quando sono necessari il valore/i valori del parametro di riferimento.

Vecchia implementazione

 public object CalculateCustomFunction(string functionName, ArrayList paramsList, ArrayList contextObjects)

{

    ...

    object o = paramsList[i];

    if (o is Array)

    {

        ...

    }

    else if...

    ...

}

Nuova implementazione

 public object CalculateCustomFunction(string functionName, ArrayList paramsList, ArrayList contextObjects)

{

    ...

    object o = paramsList[i];

    if(o is ReferredArea) //fetch data from reference

    {

        ReferredArea ra = (ReferredArea)o;

        if(ra.IsArea)

        {

            o = ra.GetValues();

        }

        else

        {

            o = ra.GetValue(0, 0);

        }

    }

    if (o is Array)

    {

        ...

    }

    else if...

    ...

}

Class CalculationOptions aggiunto

Aspose.Cells for .NET 8.5.0 ha esposto la classe CalculationOptions per aggiungere maggiore flessibilità ed estensibilità al motore di calcolo delle formule. La classe appena aggiunta ha le seguenti proprietà.

CalculationOptions.CalcStackSize: specifica la dimensione dello stack per il calcolo delle celle in modo ricorsivo. -1 specifica che il calcolo utilizzerà WorkbookSettings.CalcStackSize della cartella di lavoro corrispondente.
CalculationOptions.CustomFunction: estende il motore di calcolo delle formule con una formula personalizzata.
CalculationOptions.IgnoreError: il valore di tipo booleano indica se gli errori devono essere nascosti durante il calcolo delle formule, dove gli errori potrebbero essere dovuti alla funzione non supportata, al collegamento esterno o altro.
CalculationOptions.PrecisionStrategy: valore di tipo CalculationPrecisionStrategy che specifica la strategia per l’elaborazione della precisione del calcolo.

Calcolo dell’enumerazioneStrategia di precisione Aggiunta

Aspose.Cells for .NET 8.5.0 ha esposto l’enumerazione CalculationPrecisionStrategy per aggiungere maggiore flessibilità al motore di calcolo delle formule per ottenere i risultati desiderati. Questa enumerazione definisce la gestione della precisione del calcolo. A causa del problema di precisione dell’aritmetica in virgola mobile IEEE 754, alcune formule apparentemente semplici potrebbero non essere calcolate per fornire i risultati previsti, pertanto l’ultima build API ha esposto i seguenti campi per ottenere i risultati desiderati in base alla selezione.

CalculationPrecisionStrategy.Decimal: utilizza decimal come operando ove possibile ed è molto inefficiente per considerazioni sulle prestazioni.
CalculationPrecisionStrategy.Round: arrotonda i risultati del calcolo in base alla cifra significativa.
CalculationPrecisionStrategy.None: non viene applicata alcuna strategia, pertanto durante il calcolo il motore utilizza il valore double originale come operando e restituisce direttamente il risultato. Questa opzione è la più efficiente ed è applicabile nella maggior parte dei casi.

Metodi Aggiunto per utilizzare CalculationOptions

Con il rilascio di v8.5.0, Aspose.Cells API ha aggiunto versioni di sovraccarico del metodo CalculateFormula come elencato di seguito.

Workbook.CalculateFormula(OpzioniCalcolo)
Worksheet.CalculateFormula(Opzioni CalcoloOpzioni, booleano ricorsivo)
Cell.Calcola(Opzioni Calcolo)

Campo di enumerazione PasteType.RowHeights Aggiunto

Aspose.Cells Le API hanno fornito il campo di enumerazione PasteType.RowHeights allo scopo di copiare le altezze delle righe durante la copia degli intervalli. Dopo aver impostato la proprietà PasteOptions.PasteType su ((PasteType.RowHeights}}, le altezze di tutte le righe all’interno dell’intervallo di origine verranno copiate nell’intervallo di destinazione.

 //Create workbook object

Workbook workbook = new Workbook();

//Source worksheet

Worksheet srcSheet = workbook.Worksheets[0];

//Add destination worksheet

Worksheet dstSheet = workbook.Worksheets.Add("Destination Sheet");

//Set the row height of the 4th row

//This row height will be copied to destination range

srcSheet.Cells.SetRowHeight(3, 50);

//Create source range to be copied

Range srcRange = srcSheet.Cells.CreateRange("A1:D10");

//Create destination range in destination worksheet

Range dstRange = dstSheet.Cells.CreateRange("A1:D10");

//PasteOptions, we want to copy row heights of source range to destination range

PasteOptions opts = new PasteOptions();

opts.PasteType = PasteType.RowHeights;

//Copy source range to destination range with paste options

dstRange.Copy(srcRange, opts);

//Write informative message in cell D4 of destination worksheet

dstSheet.Cells["D4"].PutValue("Row heights of source range copied to destination range");

//Save the workbook in xlsx format

workbook.Save("output.xlsx", SaveFormat.Xlsx);

Proprietà SheetRender.PageScale aggiunto

Quando si imposta il ridimensionamento dell’impostazione di pagina utilizzandoAdatta a n pagine di larghezza per m di altezza opzione, Microsoft Excel calcola il fattore di scala Imposta pagina. Lo stesso può essere ottenuto utilizzando la proprietà SheetRender.PageScale esposta da Aspose.Cells for .NET 8.5.0. Questa proprietà restituisce un valore double che può essere convertito in valore percentuale. Ad esempio, se restituisce 0,507968245, significa che il fattore di scala è del 51%.

 //Create workbook object

Workbook workbook = new Workbook();

//Access first worksheet

Worksheet worksheet = workbook.Worksheets[0];

//Put some data in these cells

worksheet.Cells["A4"].PutValue("Test");

worksheet.Cells["S4"].PutValue("Test");

//Set paper size

worksheet.PageSetup.PaperSize = PaperSizeType.PaperA4;

//Set fit to pages wide as 1

worksheet.PageSetup.FitToPagesWide = 1;

//Calculate page scale via sheet render

SheetRender sr = new SheetRender(worksheet, new ImageOrPrintOptions());

//Convert page scale double value to percentage

string strPageScale = sr.PageScale.ToString("0%");

//Write the page scale value

Console.WriteLine(strPageScale);

Enumerazione CellValueFormatStrategy aggiunta

Aspose.Cells for .NET 8.5.0 ha aggiunto una nuova enumerazione CellValueFormatStrategy per gestire le situazioni in cui i valori delle celle devono essere estratti con o senza formattazione applicata. L’enumerazione CellValueFormatStrategy ha i seguenti campi.

CellValueFormatStrategy.CellStyle: formattato solo con il formato originale della cella.
CellValueFormatStrategy.DisplayStyle: formattato con lo stile visualizzato della cella.
CellValueFormatStrategy.None: non formattato.

Metodo Cell.GetStingValue Added

Per utilizzare l’enumerazione CellValueFormatStrategy, v8.5.0 ha esposto il metodo Cell.GetStingValue che potrebbe accettare un parametro di tipo CellValueFormatStrategy e restituire il valore che dipende dall’opzione specificata.

Il seguente frammento di codice mostra come utilizzare il metodo Cells.GetStingValue appena esposto.

 //Create workbook

Workbook workbook = new Workbook();

//Access first worksheet

Worksheet worksheet = workbook.Worksheets[0];

//Access cell A1

Cell cell = worksheet.Cells["A1"];

//Put value inside the cell

cell.PutValue(0.012345);

//Format the cell that it should display 0.01 instead of 0.012345

Style style = cell.GetStyle();

style.Number = 2;

cell.SetStyle(style);

//Get string value as Cell Style

string value = cell.GetStingValue(CellValueFormatStrategy.CellStyle);

Console.WriteLine(value);

//Get string value without any formatting

value = cell.GetStingValue(CellValueFormatStrategy.None);

Console.WriteLine(value);

Proprietà ExportTableOptions.FormatStrategy aggiunta

Aspose.Cells for .NET 8.5.0 ha esposto la proprietà ExportTableOptions.FormatStrategy per gli utenti che desiderano esportare i dati in DataTable con o senza formattazione. Questa proprietà utilizza l’enumerazione CellValueFormatStrategy ed esporta i dati in base all’opzione specificata.

Il codice seguente spiega l’uso della proprietà ExportTableOptions.FormatStrategy.

 //Create workbook

Workbook workbook = new Workbook();

//Access first worksheet

Worksheet worksheet = workbook.Worksheets[0];

//Access cell A1

Cell cell = worksheet.Cells["A1"];

//Put value inside the cell

cell.PutValue(0.012345);

//Format the cell that it should display 0.01 instead of 0.012345

Style style = cell.GetStyle();

style.Number = 2;

cell.SetStyle(style);

//Print the cell values as it displays in excel

Console.WriteLine("Cell String Value: " + cell.StringValue);

//Print the cell value without any format

Console.WriteLine("Cell String Value without Format: " + cell.StringValueWithoutFormat);

//Export Data Table Options with FormatStrategy as CellStyle

ExportTableOptions opts = new ExportTableOptions();

opts.ExportAsString = true;

opts.FormatStrategy = CellValueFormatStrategy.CellStyle;

//Export Data Table

DataTable dt = worksheet.Cells.ExportDataTable(0, 0, 1, 1, opts);

//Print the value of very first cell

Console.WriteLine("Export Data Table with Format Strategy as Cell Style: " + dt.Rows[0][0].ToString());

//Export Data Table Options with FormatStrategy as None

opts.FormatStrategy = CellValueFormatStrategy.None;

dt = worksheet.Cells.ExportDataTable(0, 0, 1, 1, opts);

//Print the value of very first cell

Console.WriteLine("Export Data Table with Format Strategy as None: " + dt.Rows[0][0].ToString());

Pubblico API Modifiche Aspose.Cells 8.4.2 Pubblico API Modifiche Aspose.Cells 8.5.1