Offentlig API Ändringar i Aspose.Cells 8.8.3

Det här dokumentet beskriver ändringarna av Aspose.Cells API från version 8.8.2 till 8.8.3 som kan vara av intresse för modul-/applikationsutvecklare. Den innehåller inte bara nya och uppdaterade offentliga metoder, tillagda och borttagna klasser etc., utan också en beskrivning av eventuella förändringar i beteendet bakom kulisserna i Aspose.Cells.

Lade till API:er

Stöd för ActiveX-kontroller

Aspose.Cells for .NET 8.8.3 har avslöjat metoden AddActiveXControl som gör det möjligt att lägga till en ActiveX-kontroll till ShapeCollection. Den ovannämnda metoden kräver 7 parametrar för att specificera kontrolltyp, plats för att placera kontroll och storlek på kontroll. Typen kan specificeras med hjälp av ControlType-uppräkningen med följande möjliga värden.

ControlType.CheckBox
ControlType.ComboBox
ControlType.CommandButton
ControlType.Image
ControlType.Label
ControlType.ListBox
ControlType.RadioButton
ControlType.ScrollBar
ControlType.SpinButton
ControlType.TextBox
ControlType.ToggleButton
ControlType.Okänd

För mer information om den här funktionen, läs den detaljerade artikeln omLägga till ActiveX-kontroller i arbetsbladet.

Följande är det enkla användningsscenariot.

 // 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);

Lade till LoadOptions.SetPaperSize Method

Aspose.Cells for .NET 8.8.3 gör det möjligt att ställa in standardstorleken för utskriftspapper från standardskrivarens inställning medan du använder den nyligen exponerade metoden LoadOptions.SetPaperSize som visas nedan. Observera att indataparametern för ovannämnda metod är värdet från uppräkningen PaperSizeType som innehåller de fördefinierade pappersstorlekarna.

För mer information om den här funktionen, läs den detaljerade artikeln omLadda kalkylblad med specificerad pappersstorlek.

Följande är det enkla användningsscenariot.

 // 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);

Lade till Cell.GetCharacters(flagga) Method

Aspose.Cells API:er gör det möjligt att hämta teckenobjekten i form av FontSetting-arrayen genom att använda metoden Cell.GetCharacters. Med den här versionen har Aspose.Cells for .NET API avslöjat en överbelastad version av Cell.GetCharacters som kan acceptera Boolean som parameter, vilket indikerar om tabellstilen måste tillämpas på cellen om cellen är en del av ett ListObject.

 // 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);

Lade till egenskapen OleObject.AutoLoad

Aspose.Cells for .NET 8.8.3 har exponerat egenskapen OleObject.AutoLoad som gör det möjligt att uppdatera OleObjects bild om innehållet/data för det underliggande objektet har ändrats. Den tidigare nämnda egenskapen när den är satt till true tvingar Excel-applikationen att uppdatera OleObjects bild när det resulterande kalkylbladet laddas.

För mer information om den här funktionen, läs den detaljerade artikeln omUppdatera OleObjects automatiskt.

Följande är det enkla användningsscenariot.

 // 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;

Tillagd HTMLLoadOptions.SupportDivTag-egenskap

Aspose.Cells for .NET 8.8.3 har avslöjat egenskapen HTMLLoadOptions.SupportDivTag som gör det möjligt att analysera DIV-taggar inbäddade i TD-taggar medan HTML-filer/snippet laddas i Aspose.Cells-objektmodellen. Boolesk typegenskap har standardvärdet false.

För mer information om den här funktionen, läs den detaljerade artikeln omStöd inre DIV-taggar under laddning HTML.

Följande är det enkla användningsscenariot.

 // 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>abc@abc.com</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);

}

Tillagd HtmlSaveOptions.ExportGridLines Property

Aspose.Cells for .NET 8.8.3 har exponerat egenskapen HtmlSaveOptions.ExportGridLines som gör det möjligt att rendera rutnätslinjerna medan kalkylblad exporteras till formatet HTML. Egenskapen av typen Boolean har standardvärdet false, men när den är inställd på true, återger API rutnätslinjerna för det tillgängliga dataintervallet i formatet HTML.

För mer information om den här funktionen, läs den detaljerade artikeln omGör rutnätslinjer till HTML.

Följande är det enkla användningsscenariot.

 // 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);

Tillagd ListObject.Comment-egenskap

Aspose.Cells API:er tillåter nu att hämta och ställa in kommentarerna för en instans av ListObject. För att tillhandahålla den ovannämnda funktionen har API:erna Aspose.Cells exponerat egenskapen ListObject.Comment.

För mer information om den här funktionen, läs den detaljerade artikeln omLägga till kommentarer för ListObjects.

Följande är det enkla användningsscenariot.

 // 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");

Lade till GridWeb.SessionStorePath-egenskap

Aspose.Cells.GridWeb for .NET 8.8.3 har exponerat SessionStorePath-egenskapen som gör det möjligt att hämta eller ställa in sessionslagringssökvägen när Session Mode är ViewState. Den ovannämnda egenskapen hämtar eller ställer in den relativa sökvägen till den aktuella webbapplikationens Baskatalog.

För mer information om den här funktionen, läs den detaljerade artikeln omAnge sökväg för tillfälliga sessionsfiler.

Följande är det enkla användningsscenariot.

Borttagna API:er

Borttagen Workbook.Decrypt Method

Nämnda egendom märktes föråldrad för en tid sedan. Den här versionen har helt tagit bort den från den offentliga API. Det rekommenderas att ställa in WorkbookSettings.Password-egenskapen på null för att uppnå samma mål.

Offentlig API Ändringar i Aspose.Cells 8.8.2 Offentlig API Ändringar i Aspose.Cells 8.9.0