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

Этот документ описывает изменения в API Aspose.Cells с версии 16.12.0 до 17.1.0, которые могут быть интересны для разработчиков модулей/приложений. Он включает не только новые и обновленные общедоступные методы, добавленные и удаленные классы и т. д., но также описание любых изменений в поведении внутри Aspose.Cells.

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

Поддержка диаграмм Excel 2016

API Aspose.Cells добавили поддержку нескольких диаграмм Excel 2016 путем расширения перечисления ChartType. Следующие новые поля были добавлены с выпуском Aspose.Cells 17.1.0.

ChartType.BoxWhisker: Серия представлена в виде ящика и усов.
ChartType.Funnel: Серия представлена в виде воронки.
ChartType.ParetoLine: Серия представлена в виде кривых Парето.
ChartType.Sunburst: Серия представлена в виде sunburst.
ChartType.Treemap: Серия представлена в виде дерева.
ChartType.Waterfall: Серия представлена в виде водопада.
ChartType.Histogram: Серия представлена в виде гистограммы.

Проверьте подробную статью по чтению типов диаграмм Excel 2016

Добавлен сеттер для свойства LoadFilter.LoadDataFilterOptions

Aspose.Cells 17.1.0 добавил сеттер для свойства LoadFilter.LoadDataFilterOptions для замены переменной экземпляра m_LoadDataFilterOptions. Пользователи могут изменять свойство LoadDataFilterOptions в собственной реализации класса LoadFilter, чтобы изменить поведение загрузки шаблонных файлов.

Вот простой сценарий использования.

Проверьте подробную статью по Custom Template Filtering

 class CustomFilter : Aspose.Cells.LoadFilter

{

    public override void StartSheet(Worksheet sheet)

    {

        if (sheet.Name == "Sheet1")

        {

            // Load everything

            this.LoadDataFilterOptions = LoadDataFilterOptions.All;

        }

        else

        {

            // Load nothing

            this.LoadDataFilterOptions = LoadDataFilterOptions.None;

        }

    }

}

Добавлено свойство CellsHelper.SignificantDigits

Aspose.Cells 17.1.0 вывело свойство SignificantDigits из класса CellsHelper, которое позволяет устанавливать количество значащих цифр для числовых значений в электронной таблице. Значение по умолчанию свойства CellsHelper.SignificantDigits равно 17 и применимо только в случае, если результат должен быть сохранен в формате файла XLSX.

Вот простой сценарий для демонстрации использования свойства CellsHelper.SignificantDigits.

Проверьте подробную статью по Setting Number of Significant Digits

 // Specify the number of significant digits

CellsHelper.SignificantDigits = 15;

Добавлено свойство GlowEffect.Color

Aspose.Cells 17.1.0 добавил свойство GlowEffect.Color, которое можно использовать для извлечения цвета свечения.

Следующий фрагмент использует свойство GlowEffect.Color.

Проверьте подробную статью по Reading the Shape’s Glow Color

 // Read the source excel file

var book = new Workbook(dir + "sample.xlsx");

// Access first worksheet

var sheet = book.Worksheets[0];

// Access the first shape

var shape = sheet.Shapes[0];

// Read the glow effect color

var glow = shape.Glow;

var color = glow.Color;

Добавлены свойства PageSetup.PaperWidth и PaperHeight.

Aspose.Cells 17.1.0 добавил свойства PaperWidth и PaperHeight для класса PageSetup. Свойства PageSetup.PaperWidth и PageSetup.PaperHeight имеют тип double и представляют ширину и высоту бумаги в дюймах с учетом ориентации страницы.

Проверьте подробную статью по Retrieving Worksheet’s Paper Size

Добавлено свойство WorkbookSettings.CheckCustomNumberFormat.

Aspose.Cells 17.1.0 добавил свойство CheckCustomNumberFormat в класс WorkbookSettings. CheckCustomNumberFormat полезен для проверки, правильно ли установлено свойство Style.Custom или нет. Если свойство Style.Custom было неправильно установлено, т.е. значение не соответствует действительному шаблону, то API Aspose.Cells выдаст исключение CellsException с соответствующим сообщением.

Проверьте подробную статью по Verifying Custom Format

 // Create an instance of Workbook

var book = new Workbook();

// Set CheckCustomNumberFormat property to true

book.Settings.CheckCustomNumberFormat = true;

// Access first worksheet

var sheet = book.Worksheets[0];

// Access a cell

var cell = sheet.Cells["B5"];

// Insert a value to the cell

cell.PutValue(2347);

// Access cell's style

Style style = cell.GetStyle();



// Set Custom property to an invalid pattern

style.Custom = "ggg @ fff";

// Set the modified style to the cell

cell.SetStyle(style);

Добавлено поле DisplayUnitType.Percentage

Aspose.Cells 17.1.0 также добавил поле Percentage в перечисление DisplayUnitType. Поле DisplayUnitType.Percentage указывает, что значения на диаграмме будут делиться на 0.01.

Удалены API

Экземплярная переменная m_LoadDataFilterOptions удалена.

Этот релиз удалил экземплярную переменную m_LoadDataFilterOptions. Рекомендуется использовать свойство LoadFilter.LoadDataFilterOptions вместо нее.

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