Público API e alterações incompatíveis com versões anteriores

A seguir está uma lista de quaisquer alterações feitas no público API, como membros adicionados, renomeados, removidos ou obsoletos, bem como qualquer alteração não compatível com versões anteriores feita em Aspose.Cells for .NET. Se você tiver dúvidas sobre qualquer alteração listada, por favor, levante-a em o fórum de suporte Aspose.Cells.

Adicionada propriedade HTMLLoadOptions.AutoFitColsAndRows

Esta versão do Aspose.Cells for .NET API adicionou a propriedade HTMLLoadOptions.AutoFitColsAndRows que indica se o API deve ajustar automaticamente colunas e linhas ao importar o HTML em seu modo de objeto. A propriedade do tipo Boolean tem como valor padrão false o que significa que as alturas e larguras das células serão importadas como estão, porém, quando a propriedade mencionada é definida como true, o API tenta ajustar as larguras das colunas e alturas das linhas de acordo com o conteúdo .

Aqui está o cenário de uso simples da propriedade 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);

Adicionadas propriedades LoadOptions.WarningCallback e WorkbookSettings.WarningCallback

Aspose.Cells for .NET 17.02.0 expôs a propriedade WarningCallback às classes LoadOptions e WorkbookSettings para obter ou definir o retorno de chamada de aviso. Os desenvolvedores precisam implementar a interface IWarningCallback para obter avisos personalizados em seus aplicativos.

Aqui está um cenário de uso simples da propriedade LoadOptions.WarningCallback para obter avisos quando uma planilha de entrada contém intervalos nomeados duplicados.

 public class WarningCallback : IWarningCallback

{

    public void Warning(WarningInfo warningInfo)

    {

        if (warningInfo.WarningType == WarningType.DuplicateDefinedName)

        {

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

        }

    }

}

Aqui está como usar a classe personalizada definida acima.

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

Método Cells.TextToColumns adicionado

A última revisão das APIs Aspose.Cells for .NET expôs o método Cells.TextToColumns para imitar o ExcelTexto para colunas recurso. O Excel fornece esse recurso deFerramentas de dados debaixo deDados aba. Observe que, para dividir o conteúdo de uma coluna em várias colunas, os dados devem conter um delimitador específico, como uma vírgula (ou qualquer outro caractere), com base no qual o API tenta dividir o conteúdo de uma célula em várias células.

Aqui está um cenário de uso simples para demonstrar o uso do API recém-exposto.

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

Método Workbook.GetFonts adicionado

Aspose.Cells for .NET 17.02.0 expôs o método GetFonts para a classe Workbook. O método Workbook.GetFonts retorna a lista de fontes individuais usadas para formatar o conteúdo das células de uma determinada planilha. O tipo de retorno do método mencionado é um array do tipo Aspose.Cells.Font class.

trecho de código a seguir demonstra o uso do método 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);

}

Adicionada propriedade TxtSaveOptions.TrimLeadingBlankRowAndColumn

Esta revisão de Aspose.Cells for .NET expôs a propriedade TrimLeadingBlankRowAndColumn do tipo booleano para a classe TxtSaveOptions que indica se as linhas e colunas em branco iniciais devem ser aparadas como o Excel faz ao exportar dados para CSV ou formatos delimitados por tabulação. Caso os dados da planilha não comecem na primeira célula, ou seja: A1, o aplicativo Excel remove as linhas e colunas em branco iniciais ao exportar os dados para os formatos CSV ou delimitado por tabulação, porém, as APIs Aspose.Cells por padrão, retêm as linhas e colunas em branco para a mesma amostra, a fim de manter o local dos dados retido se os arquivos CSV exportados ou delimitados por tabulação precisarem ser importados de volta usando APIs Aspose.Cells.

Aqui está um cenário de uso simples da propriedade 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);

Adicionada propriedade BuiltInDocumentPropertyCollection.Revision e propriedade obsoleta BuiltInDocumentPropertyCollection.RevisionNumber

Em vez disso, use a propriedade BuiltInDocumentPropertyCollection.Revision.

Adicionada propriedade Shape.TextShapeType

A propriedade Shape.TextShapeType obtém ou define o tipo de forma de texto predefinido de uma lista de tipos predefinidos armazenados na enumeração AutoShapeType.

Adicionadas propriedades ExportTableOptions.RenameStrategy e enumeração RenameStrategy

Aspose.Cells for .NET 17.02.0 expôs a propriedade ExportTableOptions.RenameStrategy junto com a enumeração RenameStrategy para lidar com o cenário em que a primeira linha de dados a ser exportada contém entradas duplicadas. Se a propriedade ExportTableOptions.ExportColumnName estiver configurada como true, o API causará exceção indicando que um DataTable não pode ter colunas com mesmos nomes. Com as novas alterações em vigor, API permite acrescentar dígitos ou letras aos nomes de colunas duplicados, enquanto o valor apropriado da enumeração RenameStrategy decide como renomear os nomes de colunas duplicados.

Aqui está um cenário de uso simples que demonstra as APIs recentemente expostas.

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

Adicionados métodos GridDesktop.DoSplit e GridDesktop.UnDoSplit

Aspose.Cells.GridDesktop for .NET 17.02.0 forneceu dois novos métodos que podem dividir o conteúdo da planilha em painéis ou mesclar os painéis existentes.

Exemplos de uso

Por favor, verifique a lista de tópicos de ajuda adicionados nos documentos Wiki Aspose.Cells:

1. Colunas e linhas de ajuste automático ao carregar HTML na pasta de trabalho
2. Converter texto em colunas usando Aspose.Cells
3. Obtenha uma lista de fontes usadas em uma planilha ou pasta de trabalho
4. Receba avisos ao carregar arquivo Excel
5. Ler e manipular gráficos do Excel 2016
6. Corte linhas e colunas em branco iniciais ao exportar planilhas para o formato CSV
7. Vinculando planilha a um objeto de coleção personalizado usando GridWeb
8. Renomeie colunas duplicadas automaticamente ao exportar dados da planilha
9. Dividir painéis na planilha GridDesktop