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

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

Добавлены API

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

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

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

Ознакомьтесь с подробной статьей оЧтение типов диаграмм Excel 2016

Добавлен установщик для свойства LoadFilter.LoadDataFilterOptions.

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

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

Ознакомьтесь с подробной статьей оПользовательская фильтрация шаблонов

 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.

Ознакомьтесь с подробной статьей оУстановка количества значащих цифр

 // Specify the number of significant digits

CellsHelper.SignificantDigits = 15;

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

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

В следующем фрагменте используется свойство GlowEffect.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, представляющий ширину и высоту бумаги в дюймах с учетом ориентации страницы.

Ознакомьтесь с подробной статьей оПолучение размера бумаги рабочего листа

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

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

Ознакомьтесь с подробной статьей оПроверка пользовательского формата

 // 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