Aspose.Cells for .NET 17.02.0 Примечания к выпуску

Public API и обратно несовместимые изменения

Ниже приведен список любых изменений, внесенных в общедоступный номер API, таких как добавленные, переименованные, удаленные или устаревшие члены, а также любые несовместимые с предыдущими изменениями, внесенные в номер Aspose.Cells for .NET. Если у вас есть сомнения по поводу каких-либо перечисленных изменений, сообщите об этом в форум поддержки Aspose.Cells.

Добавлено свойство HTMLLoadOptions.AutoFitColsAndRows.

В этом выпуске Aspose.Cells for .NET API добавлено свойство HTMLLoadOptions.AutoFitColsAndRows, которое указывает, должен ли API автоматически подбирать столбцы и строки при импорте HTML в объектном режиме. Свойство логического типа имеет значение по умолчанию false, что означает, что высота и ширина ячеек будут импортированы как есть, однако, когда для вышеупомянутого свойства установлено значение true, API пытается настроить ширину столбцов и высоту строк в соответствии с содержимым .

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

 // Create an instance of HTMLLoadOptions

var loadOptions = new HTMLLoadOptions();

// Set the AutoFitColsAndRows property to true

loadOptions.AutoFitColsAndRows = true;

// Create an instance of Workbook and load HTML while passing

// the object of HTMLLoadOptions class created above

var book = new Workbook(dir + "sample.htm", loadOptions);

Добавлены свойства LoadOptions.WarningCallback и WorkbookSettings.WarningCallback.

Aspose.Cells for .NET 17.02.0 предоставило свойство WarningCallback классам LoadOptions и WorkbookSettings для получения или установки обратного вызова предупреждения. Разработчики должны реализовать интерфейс IWarningCallback, чтобы получать настраиваемые предупреждения в своих приложениях.

Вот простой сценарий использования свойства LoadOptions.WarningCallback для получения предупреждений, когда входная электронная таблица содержит повторяющиеся именованные диапазоны.

 public class WarningCallback : IWarningCallback

{

    public void Warning(WarningInfo warningInfo)

    {

        if (warningInfo.WarningType == WarningType.DuplicateDefinedName)

        {

            Console.WriteLine("Duplicate Defined Names Found as " + warningInfo.Description);

        }

    }

}

Вот как использовать пользовательский класс, определенный выше.

 // Create an instance of LoadOptions class

var options = new LoadOptions();

// Set the WarningCallback property to custom class

options.WarningCallback = new WarningCallback();

// Load a sample spreadsheet in an instance of Workbook while 

// passing the object of LoadOptions class as defined above

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

Добавлен метод Cells.TextToColumns.

В последней версии API Aspose.Cells for .NET был представлен метод Cells.TextToColumns для имитации метода Excel.Текст в столбцы особенность. Excel предоставляет эту функцию изИнструменты данных подДанныевкладка Обратите внимание, что для разделения содержимого столбца на несколько столбцов данные должны содержать определенный разделитель, например запятую (или любой другой символ), на основе которого API пытается разделить содержимое ячейки на несколько ячеек.

Вот простой сценарий использования, демонстрирующий использование недавно выставленного API.

 // Create an instance of Workbook and load a sample

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

// Retrieve the cells collection of the first worksheet in the sample

var cells = book.Worksheets[0].Cells;

// Create an instance of TxtLoadOptions

var options = new TxtLoadOptions();

// Specify the separator

options.Separator = ',';

// Split the data in range B2:B4

cells.TextToColumns(1, 1, 3, options);

Добавлен метод Workbook.GetFonts

Aspose.Cells for .NET 17.02.0 предоставил метод GetFonts для класса Workbook. Метод Workbook.GetFonts возвращает список отдельных шрифтов, используемых для форматирования содержимого ячеек данной электронной таблицы. Тип возвращаемого значения вышеупомянутого метода — массив типа Aspose.Cells.Font class.

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

 // Create an instance of Workbook and load a sample

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

// Retrieve the list of fonts used in spreadsheet

var fonts = book.GetFonts();

// Iterate the list and write font name

foreach (Aspose.Cells.Font font in fonts)

{

    Console.WriteLine(font.Name);

}

Добавлено свойство TxtSaveOptions.TrimLeadingBlankRowAndColumn.

В этой версии Aspose.Cells for .NET представлено свойство TrimLeadingBlankRowAndColumn логического типа для класса TxtSaveOptions, которое указывает, следует ли обрезать ведущие пустые строки и столбцы, как это делает Excel, при экспорте данных в форматы CSV или с разделителями табуляции. Значение по умолчанию для вышеупомянутого свойства — false. Если данные на листе не начинаются с первой ячейки, то есть: A1, приложение Excel удаляет начальные пустые строки и столбцы при экспорте данных в форматы CSV или с разделителями табуляции, однако API-интерфейсы Aspose.Cells по умолчанию сохраняют пустые строки и столбцы для одного и того же образца, чтобы сохранить местоположение данных, если экспортированные файлы CSV или файлы с разделителями табуляцией должны быть импортированы обратно с использованием API Aspose.Cells.

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

 // Create an instance of Workbook and load a sample

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

// Create an instance of TxtSaveOptions

var options = new TxtSaveOptions();

// Set TrimLeadingBlankRowAndColumn property to true

options.TrimLeadingBlankRowAndColumn = true;

// Export to CSV format while removing the leading blank rows & columns

book.Save(dir + "output.csv", options);

Добавлено свойство BuiltInDocumentPropertyCollection.Revision и устаревшее свойство BuiltInDocumentPropertyCollection.RevisionNumber.

Вместо этого используйте свойство BuiltInDocumentPropertyCollection.Revision.

Добавлено свойство Shape.TextShapeType.

Свойство Shape.TextShapeType получает или задает предустановленный тип текстовой фигуры из списка предопределенных типов, хранящихся в перечислении AutoShapeType.

Добавлено свойство ExportTableOptions.RenameStrategy и перечисление RenameStrategy.

Aspose.Cells for .NET 17.02.0 предоставило свойство ExportTableOptions.RenameStrategy вместе с перечислением RenameStrategy, чтобы справиться со сценарием, в котором первая строка экспортируемых данных содержит повторяющиеся записи. Если для свойства ExportTableOptions.ExportColumnName задано значение true, API вызовет исключение, указывающее, что DataTable не может иметь столбцы с одинаковыми именами. После внесения новых изменений API позволяет добавлять цифры или буквы к повторяющимся именам столбцов, тогда как соответствующее значение из перечисления RenameStrategy решает, как переименовать повторяющиеся имена столбцов.

Вот простой сценарий использования, демонстрирующий недавно открытые API.

 // Create an instance of Workbook

var book = new Workbook();

// Retrieve the cells collection of first worksheet

var cells = book.Worksheets[0].Cells;

// Insert similar values in first row

// These values will serve as column names while exporting to DataTable

cells["A1"].PutValue("Column A");

cells["B1"].PutValue("Column A");

cells["C1"].PutValue("Column A");

// Insert some more data that will serve as first row of DataTable

cells["A2"].PutValue("Value 1");

cells["B2"].PutValue("Value 2");

cells["C2"].PutValue("Value 3");

// Create an instance of ExportTableOptions

var options = new ExportTableOptions();

// Set ExportColumnName property to true so that the 

// first row of worksheet data becomes the columns names of DataTable

options.ExportColumnName = true;

// Set the renaming strategy to Letter, 

// indicating the the API will append letters to duplicate column names

options.RenameStrategy = RenameStrategy.Letter;

// Export the data to DataTable while using the object of ExportTableOptions class

var table = cells.ExportDataTable(0, 0, 2, 3, options);

Добавлены методы GridDesktop.DoSplit и GridDesktop.UnDoSplit.

Aspose.Cells.GridDesktop for .NET 17.02.0 предоставляет два новых метода, которые могут либо разделить содержимое рабочего листа на панели, либо объединить существующие панели.

Примеры использования

Пожалуйста, проверьте список разделов справки, добавленных в Aspose.Cells вики-документы:

1. Автоподбор столбцов и строк при загрузке HTML в книгу
2. Преобразование текста в столбцы с помощью Aspose.Cells
3. Получить список шрифтов, используемых в электронной таблице или книге
4. Получать предупреждения при загрузке файла Excel
5. Чтение и обработка диаграмм Excel 2016
6. Обрезать начальные пустые строки и столбцы при экспорте электронных таблиц в формат CSV
7. Привязка рабочего листа к настраиваемому объекту коллекции с помощью GridWeb
8. Автоматическое переименование повторяющихся столбцов при экспорте данных листа
9. Разделение панелей на рабочем листе GridDesktop