Modifiche all API pubblica in Aspose.Cells 8.7.2

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

API aggiunte

Esteso il Motore di Calcolo Predefinito

Le API di Aspose.Cells hanno un potente motore di calcolo che può calcolare quasi tutte le funzioni di Microsoft Excel. Inoltre, le API di Aspose.Cells consentono ora di estendere il motore di calcolo predefinito per soddisfare i requisiti di calcolo personalizzati di qualsiasi applicazione.

Le API seguenti sono state aggiunte con il rilascio di Aspose.Cells for .NET 8.7.2.

1. Classe AbstractCalculationEngine
2. Classe CalculationData
3. Proprietà CalculationOptions.CustomEngine

Le API sopra menzionate consentono di implementare un motore di calcolo personalizzato per tutte le funzioni (incluso le funzioni native di Excel) con maggiore flessibilità.

Per ulteriori dettagli su questa funzione, consulta l’articolo dettagliato su Implementazione di un Motore di Calcolo Personalizzato

Di seguito è riportato il semplice scenario d’uso.

C#

 public class MyEngine : AbstractCalculationEngine

{

    public override void Calculate(CalculationData data)

    {

        string funcName = data.FunctionName.ToUpper();

        if ("MYFUNC".Equals(funcName))

        {

            //do calculation for MYFUNC here

            int count = data.ParamCount;

            object res = null;

            for (int i = 0; i < count; i++)

            {

                object pv = data.GetParamValue(i);

                if (pv is ReferredArea)

                {

                    ReferredArea ra = (ReferredArea)pv;

                    pv = ra.GetValue(0, 0);

                }

                //process the parameter here

                //res = ...;

            }

            data.CalculatedValue = res;

        }

    }

}

Aggiunto Indicizzatore Sovraccaricato per TextBoxCollection

Aspose.Cells for .NET 8.7.2 ha esposto l’indicizzatore sovraccaricato per la classe TextBoxCollection al fine di accedere all’istanza di TextBox utilizzando il suo nome come stringa.

Per ulteriori dettagli su questa funzione, consulta l’articolo dettagliato su Accesso al TextBox tramite il suo Nome

Lo scenario di utilizzo semplice appare come segue.

C#

 //Create an instance of Workbook

Workbook workbook = new Workbook();

//Access the first Worksheet from the collection

Worksheet sheet = workbook.Worksheets[0];

//Add a TextBox to the collection

int idx = sheet.TextBoxes.Add(10, 10, 10, 10);

//Access the TextBox using its index

TextBox box = sheet.TextBoxes[idx];

//Set the name for the TextBox

box.Name = "MyTextBox";

//Access the same TextBox via its name

box = sheet.TextBoxes["MyTextBox"];

Aggiunto evento OnAfterColumnFilter per GridWeb

Aspose.Cells.GridWeb per .NET 8.7.2 ha esposto l’evento OnAfterColumnFilter che funge da callback per il meccanismo di filtro effettuato tramite l’interfaccia utente di Aspose.Cells.GridWeb. Come suggerisce il nome, l’evento viene attivato dopo che il filtro delle colonne è stato applicato e può essere utilizzato per ottenere informazioni sul filtro come l’indice della colonna su cui è stato applicato il filtro e il valore del filtro selezionato.

Lo scenario di utilizzo semplice appare come segue.

C#

 protected void GridWeb1_AfterColumnFilter(object sender, Aspose.Cells.GridWeb.RowColumnEventArgs e)

{

    string msg = "Column index: " + (e.Num) + ", Filtered Value:" + e.Argument;

}

Do not forget to register the event to GridWeb control <acw:gridweb OnAfterColumnFilter=“GridWeb1_AfterColumnFilter”/>