Изменения общедоступного API в Aspose.Cells 8.4.2

Добавленные API

Улучшен механизм создания диаграмм

Класс Aspose.Cells.Charts.Chart добавил метод SetChartDataRange для упрощения задачи создания диаграмм. Метод SetChartDataRange принимает два параметра, где первый параметр типа string указывает область ячеек, из которой надо построить ряды данных. Второй параметр типа Boolean указывает ориентацию построения диаграммы, то есть, следует ли строить ряды данных диаграммы из диапазона ячеек по строкам или по столбцам.

Следующий фрагмент кода показывает, как создать столбчатую диаграмму с помощью нескольких строк кода, предполагая, что данные рядов диаграммы находятся на том же листе, с ячейки 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 для добавления нового модуля VBA к экземпляру Workbook. Метод 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 API Aspose.Cells добавил 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);