Pubblico API Modifiche Aspose.Cells 16.11.0
API aggiunte
Supporto per le impostazioni di globalizzazione
Aspose.Cells 16.11.0 ha esposto la classe GlobalizationSettings insieme alla proprietà WorkbookSettings.GlobalizationSettings per imporre alle API Aspose.Cells l’utilizzo di etichette personalizzate per i subtotali. La classe GlobalizationSettings ha i seguenti metodi che possono essere sovrascritti nell’implementazione personalizzata per dare i nomi desiderati alle etichetteTotale & Somma totale.
- GlobalizationSettings.GetTotalName: ottiene il nome totale della funzione.
- GlobalizationSettings.GetGrandTotalName: ottiene il nome del totale complessivo della funzione.
Ecco una semplice classe personalizzata che estende la classe GlobalizationSettings e ne esegue l’override dei metodi sopra menzionati per restituire etichette personalizzate per la funzione di consolidamento Average.
C#
class CustomSettings : GlobalizationSettings
{
public override string GetTotalName(ConsolidationFunction functionType)
{
switch (functionType)
{
case ConsolidationFunction.Average:
return "AVG";
default:
return base.GetTotalName(functionType);
}
}
public override string GetGrandTotalName(ConsolidationFunction functionType)
{
switch (functionType)
{
case ConsolidationFunction.Average:
return "GRD AVG";
default:
return base.GetGrandTotalName(functionType);
}
}
}
Lo snippet seguente carica un foglio di calcolo esistente e aggiunge il subtotale di tipo Media sui dati già disponibili nel foglio di lavoro. La classe CustomSettings ei relativi metodi GetTotalName e GetGrandTotalName verranno chiamati al momento dell’aggiunta di Subtotal al foglio di lavoro.
C#
// Loads an existing spreadsheet containing some data
Workbook book = new Workbook(dir + "sample.xlsx");
// Assigns the GlobalizationSettings property of the WorkbookSettings class
// to the class created in first step
book.Settings.GlobalizationSettings = new Cells.CustomSettings();
// Accesses the 1st worksheet from the collection which contains data
// Data resides in the cell range A2:B9
Worksheet sheet = book.Worksheets[0];
// Adds SubTotal of type Average to the worksheet
sheet.Cells.Subtotal(CellArea.CreateCellArea("A2", "B9"), 0, ConsolidationFunction.Average, new int[]{ 0,1 });
// Calculates Formulas
book.CalculateFormula();
// Auto fits all columns
sheet.AutoFitColumns();
// Saves the workbook on disc
book.Save(dir + "output.xlsx");
La classe GlobalizationSettings offre anche il metodo GetOtherName utile per ottenere il nome delle etichette “Altro” per i grafici a torta. Ecco un semplice scenario di utilizzo del metodo GlobalizationSettings.GetOtherName.
C#
class CustomSettings : GlobalizationSettings
{
public override string GetOtherName()
{
int lcid = System.Globalization.CultureInfo.CurrentCulture.LCID;
switch (lcid)
{
case 1033:
return "Other";
case 1036:
return "Autre";
case 1031:
return "Andere";
//Do other case
default:
return base.GetOtherName();
}
}
}
Il frammento di codice seguente carica un foglio di calcolo esistente contenente un grafico a torta ed esegue il rendering del grafico in immagine mentre utilizza la classe CustomSettings creata in precedenza.
C#
// Loads an existing spreadsheet containing a pie chart
Workbook book = new Workbook(dir + "sample.xlsx");
// Assigns the GlobalizationSettings property of the WorkbookSettings class
// to the class created in first step
book.Settings.GlobalizationSettings = new Cells.CustomSettings();
// Accesses the 1st worksheet from the collection which contains pie chart
Worksheet sheet = book.Worksheets[0];
// Accesses the 1st chart from the collection
Chart chart = sheet.Charts[0];
// Refreshes the chart
chart.Calculate();
// Renders the chart to image
chart.ToImage(dir + "output.png", new ImageOrPrintOptions());
Classe CellsFactory aggiunta
Aspose.Cells 16.11.0 ha esposto la classe CellsFactory che attualmente ha un metodo, ovvero; Crea stile. Il metodo CellsFactory.CreateStyle può essere utilizzato per creare un’istanza della classe Style senza aggiungerla al pool di stili della cartella di lavoro.
Ecco un semplice scenario di utilizzo del metodo CellsFactory.CreateStyle.
C#
// Initializes the CellsFactory class
CellsFactory factory = new CellsFactory();
// Creates an instance of Style
Style style = factory.CreateStyle();
Aggiunta proprietà Workbook.AbsolutePath
Aspose.Cells 16.11.0 ha esposto la proprietà Workbook.AbsolutePath che consente di ottenere o impostare il percorso assoluto della cartella di lavoro memorizzato nel file workbook.xml. Questa proprietà è utile solo durante l’aggiornamento dei collegamenti esterni.
Aggiunto il metodo GridHyperlinkCollection.GetHyperlink
Aspose.Cells.GridWeb 16.11.0 ha esposto il metodo GetHyperlink alla classe GridHyperlinkCollection che consente di ottenere l’istanza di GridHyperlink passando un’istanza GridCell o una coppia di interi corrispondenti agli indici di colonna di riga.
Ecco un semplice scenario di utilizzo del metodo GetHyperlink.
C#
// Gets the active worksheet from the collection
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];
// Accesses the GridHyperlinkCollection
GridHyperlinkCollection links = sheet.Hyperlinks;
// Gets hyperlink from cell A1
GridHyperlink link = links.GetHyperlink(sheet.Cells["A1"]);
// Gets hyperlink from cell D1
link = links.GetHyperlink(0, 3);
API obsolete
Costruttore di stili obsoleto
Si prega di utilizzare il metodo cellsFactory.CreateStyle come alternativa.
API eliminate
Eliminato il metodo Cell.GetConditionalStyle
Utilizzare invece il metodo Cell.GetConditionalFormattingResult.
Metodo Cells.MaxDataRowInColumn(int colonna) eliminato
Utilizzare il metodo Cells.GetLastDataRow(int) come alternativa.
Proprietà PageSetup.Draft eliminata
Si consiglia invece di utilizzare la proprietà PageSetup.PrintDraft.
Proprietà AutoFilter.FilterColumnCollection eliminata
Si prega di prendere in considerazione l’utilizzo della proprietà AutoFilter.FilterColumns per raggiungere lo stesso obiettivo.
Proprietà TickLabels.Rotation eliminata
Utilizzare invece la proprietà TickLabels.RotationAngle.