公共 API Aspose.Cells 16.11.0 的变化
添加的 API
支持全球化设置
Aspose.Cells 16.11.0 公开了 GlobalizationSettings 类以及 WorkbookSettings.GlobalizationSettings 属性，以强制 Aspose.Cells API 对小计使用自定义标签。 GlobalizationSettings 类具有以下方法，可以在自定义实现中覆盖这些方法，以便为标签指定所需的名称全部的 & 累计.
- GlobalizationSettings.GetTotalName：获取函数的总名称。
- GlobalizationSettings.GetGrandTotalName：获取函数的总计名称。
这是一个简单的自定义类，它扩展了 GlobalizationSettings 类并覆盖了上述方法以返回合并函数 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);
}
}
}
以下代码片段加载现有电子表格，并在工作表中已有的数据上添加 Average 类型的小计。在将小计添加到工作表时，将调用 CustomSettings 类及其 GetTotalName 和 GetGrandTotalName 方法。
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");
GlobalizationSettings 类还提供了 GetOtherName 方法，该方法可用于获取饼图“其他”标签的名称。这是 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();
}
}
}
以下代码片段加载包含饼图的现有电子表格，并在使用上面创建的 CustomSettings 类时将图表呈现为图像。
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());
添加了 CellsFactory 类
Aspose.Cells 16.11.0暴露了CellsFactory类，目前有一个方法，即；创建样式。 CellsFactory.CreateStyle 方法可用于创建 Style 类的实例，而无需将其添加到工作簿样式池中。
下面是 CellsFactory.CreateStyle 方法的简单使用场景。
C#
// Initializes the CellsFactory class
CellsFactory factory = new CellsFactory();
// Creates an instance of Style
Style style = factory.CreateStyle();
添加了 Workbook.AbsolutePath 属性
Aspose.Cells 16.11.0 公开了 Workbook.AbsolutePath 属性，允许获取或设置存储在 workbook.xml 文件中的绝对工作簿路径。此属性在仅更新外部链接时很有用。
添加了 GridHyperlinkCollection.GetHyperlink 方法
Aspose.Cells.GridWeb 16.11.0 已将 GetHyperlink 方法公开给 GridHyperlinkCollection 类，该类允许通过传递实例 GridCell 或一对对应于行列索引的整数来获取 GridHyperlink 的实例。
下面是 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
过时的样式构造函数
请使用 cellsFactory.CreateStyle 方法作为替代方法。
已删除的 API
删除 Cell.GetConditionalStyle 方法
请改用 Cell.GetConditionalFormattingResult 方法。
删除了 Cells.MaxDataRowInColumn(int column) 方法
请使用 Cells.GetLastDataRow(int) 方法作为替代方法。
删除 PageSetup.Draft 属性
建议改为使用 PageSetup.PrintDraft 属性。
已删除 AutoFilter.FilterColumnCollection 属性
请考虑使用 AutoFilter.FilterColumns 属性来实现相同的目标。
删除了 TickLabels.Rotation 属性
请改用 TickLabels.RotationAngle 属性。