公共 API Aspose.Cells 8.4.2 的变化

本文档描述了 Aspose.Cells API 从版本 8.4.1 到 8.4.2 的变化，模块/应用程序开发人员可能会感兴趣。它不仅包括新的和更新的公共方法，添加类等还描述了 Aspose.Cells 中幕后行为的任何变化。

添加的 API

改进的图表创建机制

Aspose.Cells.Charts.Chart 类公开了 SetChartDataRange 方法以简化图表创建任务。 SetChartDataRange 方法接受两个参数，其中第一个参数是字符串类型，指定从中绘制数据系列的单元格区域。第二个参数是指定绘图方向的布尔类型，即；是否按行或按列绘制一系列单元格值的图表数据系列。

以下代码片段展示了如何使用几行代码创建柱形图，假设图表的绘图系列数据存在于从单元格 A1 到 D4 的同一工作表中。

 //Add a new chart of type Column to chart collection

int idx = worksheet.Charts.Add(ChartType.Column, 6, 5, 20, 13);

//Retrieve the newly added chart instance

Chart chart = worksheet.Charts[idx];

//Specify the chart's data series from cell A1 to D4

chart.SetChartDataRange("A1:D4", true);

方法 VbaModuleCollection.Add 添加

Aspose.Cells for .NET 8.4.2 公开了 VbaModuleCollection.Add 方法以将新的 VBA 模块添加到工作簿的实例。 VbaModuleCollection.Add 方法接受工作表类型的参数以添加工作表特定模块。

以下代码片段显示了如何使用 VbaModuleCollection.Add 方法。

 //Create new workbook

Workbook workbook = new Workbook();

//Access first worksheet

Worksheet worksheet = workbook.Worksheets[0];

//Add VBA module for first worksheet

int idx = workbook.VbaProject.Modules.Add(worksheet);

//Access the VBA Module, set its name and code

Aspose.Cells.Vba.VbaModule module = workbook.VbaProject.Modules[idx];

module.Name = "TestModule";

module.Codes = "Sub ShowMessage()" + "\r\n" +

"    MsgBox \"Welcome to Aspose!\"" + "\r\n" +

"End Sub";

//Save the workbook

workbook.Save(output, SaveFormat.Xlsm);

重载方法 Cells.CopyColumns 添加

Aspose.Cells for .NET 8.4.2 公开了 Cells.CopyColumns 方法的重载版本，用于将源列重复到目标中。新暴露的方法一共接受5个参数，其中前4个参数与普通的Cells.CopyColumns方法相同。但是，最后一个 int 类型的参数指定了源列必须重复的目标列数。

以下代码片段显示了如何使用新公开的 Cells.CopyColumns 方法。

 //Load an existing workbook

Workbook workbook = new Workbook(input);

//Access first worksheet

Worksheet worksheet = workbook.Worksheets[0];

//Access cells of first worksheet

Cells cells = worksheet.Cells;

//Copy the first two columns (A & B) along with formatting

//to columns G, H & I.

//Please note, the columns G & H will be replaced by A & B respectively

//whereas, column I will be replaced by the column A

cells.CopyColumns(cells, 0, 2, 6, 3);

//Save the workbook

workbook.Save(output);

添加了枚举字段 PasteType.Default 和 PasteType.DefaultExceptBorders

随着 v8.4.2 的发布，Aspose.Cells API 为 PasteType 添加了 2 个新的枚举字段，详述如下。

PasteType.Default：类似于 Excel 的“全部”功能，用于粘贴单元格区域。
PasteType.DefaultExceptBorders：类似于 Excel 的“除边框外的所有内容”功能，用于粘贴单元格范围。

以下示例代码演示了 PasteType.Default 字段的使用。

 //Load an existing workbook

Workbook workbook = new Workbook(input);

//Access first worksheet

Worksheet worksheet = workbook.Worksheets[0];

//Access cells of first worksheet

Cells cells = worksheet.Cells;

//Create source & destination ranges

Range source = cells.CreateRange("A1:B6");

Range destination = cells.CreateRange("D1:E6");

//Copy the source range onto the destination range with everything except column widths

destination.Copy(source, new PasteOptions() { PasteType = PasteType.Default });

//Save the workbook

workbook.Save(output);

从 Aspose.Cells for .NET 8.4.2 版本开始，枚举字段 PasteType.All 的行为与 Excel 粘贴单元格区域的“全部”功能不同。现在，PasteType.All 还将列宽复制到目标范围，这与 Excel 的“全部”功能相反。为了模仿 Excel 的“全部”行为，请使用 PasteType.Default。

公共 API Aspose.Cells 8.4.1 的变化公共 API Aspose.Cells 8.5.0 的变化