Aspose.Cells 8.4.2中的公共API更改
Contents
[
Hide
]
该文档描述了从版本8.4.1到8.4.2的Aspose.Cells API的更改，可能对模块/应用程序开发人员感兴趣。它不仅包括新的和更新的公共方法，添加的类等，还描述了Aspose.Cells内部行为的任何变化。
添加的 API
提高了图表创建机制
Aspose.Cells.Charts.Chart类已公开SetChartDataRange方法，以简化图表创建任务。 SetChartDataRange方法接受两个参数，第一个参数是字符串类型，指定要绘制数据系列的单元格区域。第二个参数是布尔类型，指定绘制方向，即从行还是从列绘制图表数据系列。
以下代码片段展示了如何使用少量代码创建柱状图，假设图表的绘图系列数据存在于同一工作表的单元格A1到D4。
C#
//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方法，以向Workbook实例中添加新的VBA模块。VbaModuleCollection.Add方法接受Worksheet类型的参数，用于添加特定工作表的模块。
以下代码段显示了如何使用VbaModuleCollection.Add方法。
C#
//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方法。
C#
//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添加了2个新的PasteType枚举字段，如下所述。
- PasteType.Default：类似于Excel的“全部”功能，用于粘贴单元格范围。
- PasteType.DefaultExceptBorders：类似于Excel的“除边框之外的所有”功能，用于粘贴单元格范围。
下面的示例代码演示了如何使用PasteType.Default字段。
C#
//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的"All"功能粘贴单元格范围时的行为不同。现在，PasteType.All还会将列宽复制到目标范围上，而不同于Excel的"All"功能。为了模仿Excel的"All"行为，请使用PasteType.Default。