Offentlig API Ändringar i Aspose.Cells 8.8.1
Lade till API:er
Filtrera data för laddning
Aspose.Cells for .NET 8.8.1 har exponerat LoadDataFilterOptions-uppräkningen tillsammans med LoadOptions.LoadDataFilterOptions-egenskapen som kan användas för att specificera datatypen som ska laddas när arbetsboken byggs från en mallfil. Filtrering av laddade data kan förbättra prestandan för speciella ändamål, särskilt när du använder LightCells API:er.
Uppräkningen LoadDataFilterOptions ger följande val.
- Allt för att ladda allt från kalkylarket.
- Ingen för att ladda ingenting från kalkylarket.
- CellBlank laddar cellerna vars värden är tomma.
- CellBool laddar celler vars värden är booleska.
- CellData laddar celldata inklusive värden, formler och formatering.
- CellError laddar celler vars värden är fel.
- CellNumeric laddar celler vars värden är numeriska (inklusive datum och tid).
- CellString laddar celler vars värden är text/sträng.
- CellValue laddar endast cellvärden (alla typer).
- Diagram laddar bara diagram.
- ConditionalFormatting läser bara in regler för villkorlig formatering.
- DataValidation laddar endast datavalideringsregler.
- DocumentProperties laddar endast dokumentegenskaper.
- Formel laddar formler inklusive definierade namn.
- MergedArea laddar bara sammanslagna celler.
- Pivottabell laddar pivottabeller.
- Inställningar läser bara in inställningar för arbetsbok och arbetsblad.
- Shape laddar bara former.
- Stil laddar cellformatering.
- Tabell laddar Excel-tabeller/listobjekt.
Följande är det enkla användningsscenariot.
C#
//Create an instance of LoadOptions & initialize it with type of template to be loaded
var options = new LoadOptions(LoadFormat.Xlsx);
//Set LoadDataFilterOptions to load only shapes
options.LoadDataFilterOptions = LoadDataFilterOptions.Shape;
//Create an instance of Workbook from a existing spreadsheet using instance of LoadOptions
var book = new Workbook(filePath, options);
Konvertera diagram direkt till PDF
Aspose.Cells API:er har redan gjort det möjligt att rendera diagram till PDF när man använder metoden Chart.ToPdf. Med den här utgåvan har API avslöjat en annan överbelastad version av nämnda metod som kunde acceptera en instans av Stream, vilket gör att användarna kan spara sjökortets PDF i en instans av MemoryStream.
Följande är det enkla användningsscenariot.
C#
//Create an instance of Workbook and load an existing spreadsheet with a chart
var workbook = new Workbook(filePath);
//Access first worksheet containing a chart
var worksheet = workbook.Worksheets[0];
//Access first chart from the worksheet
var chart = worksheet.Charts[0];
//Save the chart to PDF as Stream
using (MemoryStream stream = new MemoryStream())
{
chart.ToPdf(stream);
}
Lade till WorkbookSettings.PaperSize-egenskap
Aspose.Cells for .NET 8.8.1 har exponerat egenskapen WorkbookSettings.PaperSize för att ställa in standardstorleken för utskriftspapper för hela kalkylarket. Egenskapen WorkbookSettings.PaperSize accepterar ett värde från PaperSizeType-uppräkningen som innehåller de fördefinierade storlekarna för de mest använda utskriftspapperstyperna.
C#
//Create an instance of Workbook
//Optionally load an existing spreadsheet
var book = new Workbook();
//Access WorkbookSettings from the Workbook
var settings = book.Settings;
//Set the default printing paper size for the Workbook
settings.PaperSize = PaperSizeType.PaperA4;
Lade till Shape.TextBody-egenskap
Den här versionen av Aspose.Cells for .NET API har exponerat Shape.TextBody för att manipulera textens aspekter i en former. Följande utdrag använder nämnda egenskap för att ställa in skuggeffekten för texten i en textruta.
C#
//Skapa en instans av Workbook
var book = new Workbook();
//Åtkomst till första kalkylbladet i arbetsboken
var sheet = book.Worksheets[0];
//Lägg till en textruta i ShapeCollection
var textBox = sheet.Shapes.AddTextBox(2, 0, 2, 0, 100, 400);
//Ställ in texten i textrutan
textBox.Text = "Denna text har följande inställningar.\n\nTexteffekter > Skugga > Offset Botten";
//Ställ in skuggeffekt för text
för (int i = 0; i< textBox.TextBody.Count; i++)
{
textBox.TextBody[i].ShapeFont.FillFormat.ShadowEffect.PresetType = PresetShadowType.OffsetBottom;
}
Lade till Worksheet.CalculateFormula(strängformel, CalculationOptions opts) Metod
Aspose.Cells for .NET 8.8.1 har avslöjat ytterligare en överbelastning för metoden CalculateFormula som ger möjlighet att beräkna en given formel direkt med anpassade alternativ.
Lade till GridCell.CreateValidation Method
Aspose.Cells.GridWeb har tillhandahållit möjligheten att direkt lägga till valideringsregeln till en enskild cell medan du använder metoden GridCell.CreateValidation. Den nämnda metoden kräver 2 parametrar. Den första är av typen GridValidationType som bestämmer valideringstypen, medan den andra parametern (isRequied) är av typen Boolean.
C#
//Access first worksheet
GridWorksheet sheet = GridWeb1.WorkSheets[0];
//Access cell B3
GridCell cell = sheet.Cells["B3"];
//Add validation inside the GridCell
//Any value which is not between 20 and 40 will cause error in a GridCell
GridValidation val = cell.CreateValidation(GridValidationType.WholeNumber, true);
val.Formula1 = "=20";
val.Formula2 = "=40";
val.Operator = GridOperatorType.Between;
val.ShowError = true;
val.ShowInput = true;
Lade till GridCell.RemoveValidation Method
Aspose.Cells.GridWeb har också tillhandahållit möjligheten att ta bort datavalideringsregeln från en GridCell när du använder metoden GridCell.RemoveValidation.
Föråldrade API:er
Föråldrad Shape.TextFrame-egenskap
Det rekommenderas att använda egenskapen Shape.TextBody.TextAlignment istället.