Modifiche all API pubblica in Aspose.Cells 8.8.3

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

API aggiunte

Supporto per i Controlli ActiveX

Aspose.Cells for .NET 8.8.3 ha esposto il metodo AddActiveXControl che consente di aggiungere un controllo ActiveX alla ShapeCollection. Il suddetto metodo richiede 7 parametri per specificare il tipo di controllo, la posizione in cui posizionare il controllo e le dimensioni del controllo. Il tipo può essere specificato utilizzando l’enumerazione ControlType con i seguenti valori possibili.

1. ControlType.CheckBox
2. ControlType.ComboBox
3. ControlType.CommandButton
4. ControlType.Image
5. ControlType.Label
6. ControlType.ListBox
7. ControlType.RadioButton
8. ControlType.ScrollBar
9. ControlType.SpinButton
10. ControlType.TextBox
11. ControlType.ToggleButton
12. ControlType.Unknown

Per ulteriori dettagli su questa funzionalità, si prega di consultare l’articolo dettagliato su Aggiungere Controlli ActiveX al Foglio di Lavoro.

Di seguito è riportato il semplice scenario d’uso.

C#

 // Create an instance of Workbook

var book = new Workbook();

// Access first worksheet from the collection

var sheet = book.Worksheets[0];

// Add Toggle Button ActiveX Control to the ShapeCollection at specified location

var shape = sheet.Shapes.AddActiveXControl(ControlType.ToggleButton, 4, 0, 4, 0, 100, 30);

// Access the ActiveX Control object and set its linked cell property

ActiveXControl control = shape.ActiveXControl;

control.LinkedCell = "A1";

// Save the result on disc

book.Save(dir + "output.xlsx", SaveFormat.Xlsx);

Aggiunto il Metodo LoadOptions.SetPaperSize

Aspose.Cells for .NET 8.8.3 consente di impostare la dimensione di stampa predefinita dalle impostazioni della stampante predefinita mentre si utilizza il metodo LoadOptions.SetPaperSize appena esposto come dimostrato di seguito. Si noti che il parametro di input per il suddetto metodo è il valore dall’enumerazione PaperSizeType contenente le dimensioni di carta predefinite.

Per ulteriori dettagli su questa funzionalità, si prega di consultare l’articolo dettagliato su Caricare Fogli di Calcolo con Dimensioni di Carta Specificate.

Di seguito è riportato il semplice scenario d’uso.

C#

 // Create an instance of LoadOptions

var loadOptions = new LoadOptions();

// Set the PaperSize property to appropriate value

loadOptions.SetPaperSize(PaperSizeType.PaperA4);

// Create an instance of Workbook and load an existing spreadsheet

var book = new Workbook(dir + "input.xlsx", loadOptions);

Aggiunto il Metodo Cell.GetCharacters(flag)

Le API di Aspose.Cells consentono di ottenere gli oggetti dei caratteri sotto forma di array FontSetting utilizzando il metodo Cell.GetCharacters. Con questa versione, la API Aspose.Cells for .NET ha esposto una versione sovraccaricata del metodo Cell.GetCharacters che può accettare un Boolean come parametro, indicando se lo stile della tabella deve essere applicato alla cella se la cella fa parte di un ListObject.

C#

 // Create an instance of Workbook and load an existing spreadsheet

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

// Access first worksheet from the collection

var sheet = book.Worksheets[0];

// Access cells collection of the first worksheet

var cells = sheet.Cells;

// Access particular cell from a ListObject

// Assuming A1 resides in a ListObject

var cell = cells["A1"];

// Get all Characters objects from the cell

var characters = cell.GetCharacters(true);

Aggiunta la Proprietà OleObject.AutoLoad

Aspose.Cells for .NET 8.8.3 ha esposto la proprietà OleObject.AutoLoad che consente di aggiornare l’immagine dell’OleObject se il contenuto/dati dell’oggetto sottostante è stato modificato. Quando la suddetta proprietà viene impostata su true, forza l’applicazione Excel ad aggiornare l’immagine dell’OleObject al caricamento del foglio di calcolo risultante.

Per maggiori dettagli su questa funzionalità, si prega di consultare l’articolo dettagliato su Aggiornamento Automatico degli OleObjects.

Di seguito è riportato il semplice scenario d’uso.

C#

 // Create an instance of Workbook and load an existing spreadsheet

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

// Access first worksheet from the collection

var sheet = book.Worksheets[0];

// Access OleObjectCollection from first worksheet

var oleObjects = sheet.OleObjects;

// Access a OleObject from the collection

var oleObject = oleObjects[0];

// Set AutoLoad to true

oleObject.AutoLoad = true;

Aggiunta la Proprietà HTMLLoadOptions.SupportDivTag

Aspose.Cells for .NET 8.8.3 ha esposto la proprietà HTMLLoadOptions.SupportDivTag che consente di analizzare i tag DIV incorporati nei tag TD durante il caricamento di file HTML/frammenti in Aspose.Cells object model. La proprietà di tipo Boolean ha il valore predefinito false.

Per maggiori dettagli su questa funzionalità, si prega di consultare l’articolo dettagliato su Supporto dei Tag DIV Interni durante il Caricamento di HTML.

Di seguito è riportato il semplice scenario d’uso.

C#

 // Store the HTML snippet in a variable

var export_html = @"

<html>

<body>

    <table>

        <tr>

            <td>

                <div>This is some Text.</div>

                <div>

                    <div>

                        <span>This is some more Text</span>

                    </div>

                    <div>

                        <span>[e-mail]</span>

                    </div>

                    <div>

                        <span>1234567890</span>

                    </div>

                    <div>

                        <span>ABC DEF</span>

                    </div>

                </div>

                <div>Generated On May 30, 2016 02:33 PM <br />Time Call Received from Jan 01, 2016 to May 30, 2016</div>

            </td>

            <td>

                <img src='ASpose_logo_100x100.png' />

            </td>

        </tr>

    </table>

</body>

</html>";

// Create an instance of MemoryStream and load the contents of the HTML

using (var stream = new MemoryStream(System.Text.Encoding.UTF8.GetBytes(export_html)))

{

    // Create an instance of HTMLLoadOptions

    var loadOptions = new HTMLLoadOptions(LoadFormat.Html);

    // Set SupportDivTag property to true

    loadOptions.SupportDivTag = true;

    // Create workbook object from the HTML using load options

    var book = new Workbook(stream, loadOptions);

    // Auto fit rows and columns of first worksheet

    var sheet = book.Worksheets[0];

    sheet.AutoFitRows();

    sheet.AutoFitColumns();

    // Save the spreadsheet on disc

    book.Save(dir + "output.xlsx", SaveFormat.Xlsx);

}

Aggiunta la Proprietà HtmlSaveOptions.ExportGridLines

Aspose.Cells for .NET 8.8.3 ha esposto la proprietà HtmlSaveOptions.ExportGridLines che consente di visualizzare le linee della griglia durante l’esportazione del foglio di calcolo nel formato HTML. La proprietà di tipo Boolean ha il valore predefinito false, tuttavia, quando impostata su true, la API renderà le linee della griglia per il intervallo dati disponibile nel formato HTML.

Per maggiori dettagli su questa funzionalità, si prega di consultare l’articolo dettagliato su Rendering delle Linee di Griglia in HTML.

Di seguito è riportato il semplice scenario d’uso.

C#

 // Create an instance of Workbook and load existing spreadsheet

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

// Create an instance of HtmlSaveOptions

var options = new HtmlSaveOptions();

// Set ExportGridLines to true

options.ExportGridLines = true;

// Save the result in HTML format

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

Aggiunta la Proprietà ListObject.Comment

Le API di Aspose.Cells ora consentono di ottenere e impostare i commenti per un’istanza di ListObject. Per fornire la suddetta funzionalità, le API di Aspose.Cells hanno esposto la proprietà ListObject.Comment.

Per maggiori dettagli su questa funzionalità, si prega di consultare l’articolo dettagliato su Aggiunta Commenti per ListObjects.

Di seguito è riportato il semplice scenario d’uso.

C#

 // Create an instance of Workbook and load existing spreadsheet

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

// Access first worksheet from the collection

var sheet = book.Worksheets[0];

// Access first ListObject from the collection of ListObjects

var listObject = sheet.ListObjects[0];

// Set comments for the ListObject

listObject.Comment = "Comments";

// Save the result on disc

book.Save(dir + "output.xlsx");

Aggiunta la Proprietà GridWeb.SessionStorePath

Aspose.Cells.GridWeb per .NET 8.8.3 ha esposto la proprietà SessionStorePath che consente di ottenere o impostare il percorso dello store della sessione quando la Modalità Sessione è ViewState. La suddetta proprietà ottiene o imposta il percorso relativo alla Base Directory dell’applicazione web corrente.

Per maggiori dettagli su questa funzionalità, si prega di consultare l’articolo dettagliato su Specificare il Percorso per i File di Sessione Temporanei.

Di seguito è riportato il semplice scenario d’uso.

API rimosse

Metodo Workbook.Decrypt rimosso

La suddetta proprietà è stata contrassegnata come obsoleta qualche tempo fa. Questa versione l’ha completamente rimossa dall’API pubblica. Si consiglia di impostare la proprietà WorkbookSettings.Password su null per raggiungere lo stesso obiettivo.