Registro de alterações da biblioteca IronXL for .NET Excel

Notas de lançamento

• Corrigido o problema de extrema lentidão na aplicação de estilos em planilhas grandes (agora 25 a 393 vezes mais rápido). Operações que antes levavam minutos em áreas com mais de 500 mil células agora são concluídas em milissegundos.

Notas de lançamento

• Atualiza as dependências internas.

Notas de lançamento

• Atualiza as dependências internas.

Notas de lançamento

• Atualiza as dependências internas.

Notas de lançamento

• CorrigidoInvalidCastExceptionao carregar determinados.xlsarquivos contendo registros de Validação de Dados.

Notas de lançamento

• Atualiza as dependências internas.

Notas de lançamento

• Corrigido um problema em que células numéricas eram detectadas incorretamente como DateTime.
• Corrigido um problema que corrompia os tipos de dados ao converter arquivos XLSX para o formato XLS.
• Corrigido um problema em que o método AutoSizeColumn superestimava a largura da coluna.

Notas de lançamento

• Atualizações IronSoftware.System.Drawing para 2025.9.3.

Notas de lançamento

• Atualizações IronSoftware.System.Drawing para 2025.8.1.

Notas de lançamento

• Atualizações IronSoftware.System.Drawing para 2025.7.12.

Notas de lançamento

Atualizações :

• Atualizações IronSoftware.System.Drawing para 2025.6.2.

Correções de erros :

• Corrige um problema em que a propriedade LastFilledCell retornava incorretamente nulo para planilhas com dados esparsos.
• Corrige um problema em que CreateNamedTable corrompia o arquivo do Excel ao adicionar tabelas a planilhas diferentes.

Notas de lançamento

• Atualizações IronSoftware.System.Drawing para 2025.5.3.

• Atualizações IronSoftware.Common para 2025.3.1.

• Corrige um problema em que Rows.Length retorna um valor incorreto quando usado com arquivos do Excel contendo mais de 500 linhas.

Notas de lançamento

• Atualiza IronSoftware.System.Drawing para a versão 2025.3.6.
• Atualiza IronSoftware.Common para a versão 2025.3.1.

Notas de lançamento

• Atualiza IronSoftware.System.Drawing para a versão 2025.3.5.
• Atualiza IronSoftware.Common para a versão 2025.2.3.

Notas de lançamento

• Atualizado IronSoftware.System.Drawing para 2025.1.6.

Notas de lançamento

• Atualizado IronSoftware.Common para 2024.11.4.
• Pacotes de dependências atualizados para corrigir vulnerabilidades de segurança conhecidas.
• Corrigido um problema que causava exceções ao carregar e salvar arquivos .xlsm.
• Corrigido um problema em que o carregamento de arquivos do Excel causava uma exceção de "nomes de peças equivalentes".
• Corrigido um problema em que a adição de linhas quebrava as fórmulas.
• Corrigido um problema em que o carregamento de arquivos do Excel com validação de dados inválida gerava exceções.
• Corrigido um problema em que a configuração do formato de número fazia com que a cor da fonte HTML gerada fosse branca.

Notas de lançamento

• Atualizado IronSoftware.System.Drawing para 2024.12.3.
• Atualizado IronSoftware.Common para 2024.11.2.
• Desempenho aprimorado na recuperação de intervalos de células (5 a 10 vezes mais rápido para arquivos de médio a grande porte).
• Avaliação de fórmulas aprimorada através do armazenamento em cache dos resultados avaliados.
• Corrigida uma exceção de referência nula que ocorria ao carregar determinados arquivos.
• Corrigido um problema na recuperação de valores de data a partir de fórmulas.
• Adicionada funcionalidade para converter Workbook e Worksheet em diferentes formatos como fluxos.

Notas de lançamento

• Atualizado IronSoftware.System.Drawing para 15/09/2024
• Atualizado IronSoftware.Common para 2024.9.38
• Adicionada a opção de alternar a direção das colunas para da direita para a esquerda, útil para idiomas como árabe, chinês e hebraico.
• Adicionados métodos para definir cores de abas com SetWorksheetTabColor e SetWorksheetTabColorIndex.
• Adicionado o método RemoveHyperlink para remover hiperlinks das células.
• Corrigido um problema em que o acesso ao hiperlink de uma célula gerava uma exceção de referência nula caso a célula não possuísse um.
• Corrigido um problema em que o acesso a hiperlinks de tipo de arquivo em arquivos XLS retornava uma string vazia.
• Corrigido um problema em que o método ToDataTable não calculava com precisão todos os tipos de dados.

Notas de lançamento

• Atualiza IronSoftware.System.Drawing para a versão 2024.9.11

Notas de lançamento

• Correções de pequenos erros

Notas de lançamento

• Correções de pequenos erros

Notas de lançamento

• Correções de pequenos erros

Notas de lançamento

• Correções de pequenos erros

Notas de lançamento

• Correções de pequenos erros
• Atualiza IronSoftware.System.Drawing para a versão 2024.5.1

Notas de lançamento

• Corrige um erro que fazia com que uma fórmula "compartilhada" (aquela que é copiada para várias células) fosse perdida ao salvar um arquivo.
• Atualiza IronSoftware.System.Drawing para a versão 2024.4.1

Notas de lançamento

• Atualiza IronSoftware.Common para a versão 2024.1.7
• Atualiza IronSoftware.System.Drawing para a versão 2024.3.4
• Corrige um erro que impedia a leitura da chave de licença do arquivo web.config no .NET Framework.

Notas de lançamento

• Atualiza IronSoftware.Common para a versão 2024.1.2
• Corrige um bug que causava uma execução muito lenta dos métodos que carregavam dados de DataSets (especificamente os métodos LoadWorkSheetsFromDataSet).
• Melhorias de desempenho resultantes da correção acima em muitos outros métodos que criam um grande número de células.
• Corrige um erro em que qualquer alteração de estilo em uma célula fazia com que a cor de primeiro plano da célula fosse definida como preta. Os métodos IronXL.Cell.Int64Value e IronXL.Cell.Int32Value estão obsoletos e serão removidos no futuro. Use IronXL.Cell.IntValue e IronXL.Cell.LongValue em vez disso
• Adiciona a classe IronXL.Cells.Comment para representar comentários de células com métodos setters e getters para todas as propriedades de comentário.
• Adiciona a propriedade Comment à classe IronXL.Cell com métodos para adicionar e remover comentários. A propriedade Comment é null se a célula não tiver nenhum comentário. Os comentários são adicionados como invisíveis por padrão.

Notas de lançamento

• Pequenas melhorias e correções de erros

Notas de lançamento

• Corrige um erro que causava exceções na criação de nomes definidos.
• Corrige os problemas em que o carregamento de planilhas contendo uma folha de gráfico gerava um erro. Observe que as planilhas de gráficos ainda não serão carregadas. O suporte para planilhas de gráficos ainda é uma funcionalidade solicitada.
• Adiciona um recurso para converter tabelas nomeadas em DataTables.
• Adiciona suporte para validações de dados:
  • Propriedade DataValidations adicionada a WorkSheet. Contém todas as validações de dados na planilha e inclui métodos para adicionar e remover validações de dados.
  • Todos os tipos de validação de dados podem ser lidos em planilhas.
  • Validações de dados WholeNumber, Decimal, TextLength, Date, List e FormulaList podem ser adicionadas a WorkSheet.

Notas de lançamento

• O IronDrawing foi atualizado para a versão 2023.11.1
• Pequenas correções e melhorias
• IronXL.Logger a classe está obsoleta. Use IronSoftware.Logger em vez disso

Notas de lançamento

• O IronDrawing foi atualizado para a versão 2023.10.2
• Adicionada dependência em IronSoftware.Common 2023.10.2
• Pequenas correções e melhorias

Notas de lançamento

• O IronDrawing foi atualizado para a versão 2023.9.2.
• Melhorias de estabilidade
• Melhorias de desempenho, com tempo de execução até 25% mais rápido em alguns casos.

Notas de lançamento

• Pequenas melhorias e correções.
• Atualiza as dependências.

Notas de lançamento

• Adiciona o método GetMergedRegions, que é usado para recuperar uma lista de regiões mescladas.
• Corrige um erro em que o método Clear não excluía todas as planilhas da coleção.
• Corrige um erro em que o método InsertColumn ignorava a última linha.
• Corrige um erro em que o método Range.ToDataTable parava de converter quando encontrava uma linha vazia.
• Adiciona o grupo de métodos RemoveColumn a Range, RangeRow, RangeColumn, Worksheet.
• O grupo de métodos InsertColumn agora Shift corretamente as colunas, atualizando as fórmulas e movendo os estilos junto com as células.
• Melhora o desempenho em termos de tempo em 20 a 25% em alguns casos de manipulação de grandes volumes de dados.
• Torna obsoletas as propriedades Range.AllRowsInRange e Range.AllColumnsInRange; use Range.Rows e Range.Columns em vez disso. Isso também é válido para as classes WorkSheet, RangeRow e RangeColumn.
• O intervalo de trabalho interno de WorkSheet agora será atualizado corretamente com todas as alterações feitas na planilha.
• O intervalo de trabalho interno de WorkSheet agora incluirá as colunas vazias no final do intervalo, que contêm quaisquer informações de estilo.
• Corrigidos diversos erros no método Range.Trim, incluindo um erro em que Trim não removia colunas vazias.
• Os métodos Range.RemoveColumn e Range.RemoveRow agora SEMPRE removerão a coluna/linha completamente da planilha, deslocando para cima/para a esquerda as linhas/colunas localizadas abaixo/à direita das removidas, se após a remoção a coluna/linha estiver vazia.
• Adiciona a propriedade Range.Count, que retorna o número de células no intervalo sem iterar sobre todas as células.
• Altera as propriedades Range.ColumnCount e Range.RowCount para retornar o número de colunas/linhas no intervalo sem iterar sobre todas as células.
• Melhora a documentação da classe Range e suas classes derivadas.
• Os métodos InsertRow e InsertColumn agora retornarão a linha/coluna inserida. O mesmo se aplica aos métodos InsertRows e InsertColumns, mas estes retornarão listas de colunas/linhas inseridas.
• O endereço do intervalo agora será atualizado corretamente quando o intervalo for alterado (com os métodos Subtract).
• Adiciona a propriedade WorkSheet.RangeAddress com o endereço da área em uso na folha.
• Atualiza IronSoftware.System.Drawing para a versão 2023.7.1

Notas de lançamento

• Adiciona o método SetBorderStyle, usado para definir o tipo e a cor da borda.
• Corrige um erro em que o caractere "&" nas séries dos gráficos corrompia o arquivo resultante após o salvamento.
• Corrige um bug em que, se um arquivo .xlsx (.xlsm, .xltx, etc.) tivesse uma tag br de abertura e fechamento em sua estrutura XML interna - o método WorkBook.Load lançaria uma exceção.
• Atualiza a dependência do IronDrawing para a versão 2023.6.1.

Notas de lançamento

• Corrige um problema em que as chaves de licença não eram recuperadas do web.config em alguns projetos do .NET Framework .
• Corrige possíveis avisos sobre conflitos de versão do System.Memory

Notas de lançamento

• Adiciona suporte para as chaves de licença do Iron Suite.
• Corrige problemas com chaves de licença armazenadas em arquivos .config e .json que não eram reconhecidas pelo IronXL.
• Adiciona suporte para chaves de licença armazenadas em arquivos .config e .json em subpastas do aplicativo.

Notas de lançamento

• Agora é necessário aceitar os termos do EULA antes de instalar o pacote NuGet.
• Melhora as descrições da classe Range em relação ao código IntelliSense
• Corrige um erro em que a propriedade WorkSheet.PhysicalColumnCount gerava uma exceção quando acessada sem nenhuma coluna na planilha.
• Melhora as descrições de IntelliSense para a propriedade Cell.Hyperlink
• Corrige um erro que, em alguns casos, fazia com que a propriedade Cell.Hyperlink detectasse o tipo de hiperlink errado.
• Melhora a descrição de uma exceção que ocorre quando os métodos AutoSizeColumn são usados ​​enquanto nenhuma fonte é encontrada no sistema.
• Atualiza dependências

Notas de lançamento

• O enum usado para o método WorkSheet.InsertImage foi alterado para IronXL.Drawing.Images.ImageFormat
• Corrige um erro que fazia com que os gráficos ficassem corrompidos em diferentes localidades devido ao separador decimal.
• Melhorias de desempenho

Notas de lançamento

• Corrige um bug em que uma exceção Licensing era lançada quando um aplicativo que usa o IronXL era executado com um depurador do Visual Studio conectado.
• Corrige um erro que causava uma exceção ao excluir um dos múltiplos gráficos e, em seguida, adicionar outro.
• Os títulos dos gráficos não se sobreporão mais à área do gráfico.

Notas de lançamento

• Corrige um bug em que WorkBook.ExportToHtml estava lançando uma exceção devido a cores não indexadas no documento.
• Corrige um erro em que as chamadas de getter para propriedades de Range, WorkSheet, RangeRow, RangeColumn, RangeStyle, RangeFont e RangeBorder criavam desnecessariamente todas as células no intervalo.
• Corrige um bug que causava uma exceção ao carregar arquivos .XLSX com configurações específicas WebPublishing.
• Adiciona as propriedades WorkSheet.PhysicalColumnCount e WorkSheet.PhysicalRowCount, que retornam o número de linhas e colunas fisicamente presentes nesta planilha no momento.
• Melhora e atualiza a documentação de IntelliSense para esclarecer algumas das propriedades e métodos de WorkSheet e Range.
• Melhora o desempenho ao ler qualquer uma das propriedades do objeto Range, especialmente no caso de intervalos grandes. Isso se aplica a todos os objetos que herdam de Range (WorkSheet, RangeRow, etc).

Notas de lançamento

• Adiciona sobrecargas para os métodos de carregamento WorkBook para aceitar uma senha para planilhas XLSX, XLSM e XLTX criptografadas. Lista completa de sobrecargas adicionadas:
  • TryLoad(string filename, string password, out WorkBook workBook)
  • Carregar(byte[] dados, string senha)
  • Carregar(Stream stream, string senha)
  • LoadExcel(byte [] data, string password)
  • LoadExcel(arquivo de fluxo, senha de string)
  • LoadExcel(string nome_do_arquivo, string senha)
  • FromByteArray(byte[] data, string password)
  • FromStream(Stream stream, string password)
• Adiciona um método WorkBook.Encrypt(string password) que irá escrever uma planilha em um MemoryStream, criptografá-la usando uma senha fornecida como argumento ou aquela armazenada na propriedade WorkBook.Password e retornar o resultado criptografado MemoryStream. Compatível apenas com planilhas dos tipos XLSX, XLSM e XLTX.
• Adiciona um método WorkBook.Decrypt(Stream stream, string password) que irá descriptografar um Stream com uma senha fornecida como argumento e retornar o resultado descriptografado MemoryStream. Compatível apenas com planilhas dos tipos XLSX, XLSM e XLTX.
• Corrige um erro em que alguns estilos de borda causavam uma exceção ao exportar a planilha como HTML.
• Corrige um erro em que o método InsertRow lançava uma exceção se a linha fosse inserida no lugar da última linha existente.
• Melhora a precisão dos métodos AutoSizeRow e AutoSizeColumn.
• Melhora o desempenho do método InsertRow em 25%.

Notas de lançamento

• Corrige um erro em que o primeiro ConditionalFormattingRule criado não estava funcionando corretamente.
• Corrige um erro que impedia a aplicação da cor da fonte pela regra de formatação condicional.
• Corrige um erro que criava estilos duplicados quando a propriedade Cell.FormatString era alterada em um arquivo .xlsx.
• Corrige um bug em que os métodos Range.Row(int) e Range.Column(int) podiam demorar minutos para serem executados em intervalos grandes.
• Adiciona uma enumeração IronXL.SortOrder para indicar uma direção de classificação quando aplicável.
• Adiciona os métodos Range.SortByColumn(string, SortOrder) e Range.SortByColumn(int, SortOrder) que permitem classificar um intervalo por uma coluna especificada, reorganizando as linhas de um intervalo que está sendo classificado de acordo com a nova ordem da coluna especificada.
• Remove a dependência do pacote NuGet IronDrawing e a substitui por IronSoftware.System.Drawing.

Notas de lançamento

• Corrige um problema com vários métodos que foram ofuscados incorretamente na versão anterior. Lista dos métodos afetados: IronXL.Cells.CellFont.SetColor(Color), IronXL.Cells.CellStyle.SetBackgroundColor(Color), IronXL.Cells.XlsCellBorder.SetColor(Color), IronXL.Cells.XlsCellFont.SetColor(Color), IronXL.Cells.XlsCellStyle.SetBackgroundColor(Color), IronXL.Cells.XlsxCellBorder.SetColor(Color), IronXL.Cells.XlsxCellFont.SetColor(Color), IronXL.Cells.XlsxCellStyle.SetBackgroundColor(Color), IronXL.Ranges.RangeBorder.SetColor(Color), IronXL.Ranges.RangeFont.SetColor(Color), IronXL.Ranges.RangeStyle.SetBackgroundColor(Color), IronXL.Styles.IBorder.SetColor(Color), IronXL.Styles.IFont.SetColor(Color), IronXL.Styles.IStyle.SetBackgroundColor(Color).
• Adiciona uma dependência a um pacote NuGet IronDrawing para habilitar a conversão implícita de System.Drawing.Color ao usar os métodos listados acima.
• Adiciona um método IronXL.Drawing.Images.Image.ToAnyBitmap() que cria um objeto IronSoftware.Drawing.AnyBitmap a partir de dados de bytes do objeto Image.
• Atualiza os termos e condições do Contrato de Licença de Usuário Final.
• O arquivo IronXL.dll agora está assinado.

Notas de lançamento

• Adiciona um recurso para criptografar e descriptografar arquivos ".xlsx", ".xlsm" e ".xltx" com senha. Use o método WorkBook.SaveAs(string fileName, string password) para criptografar o WorkBook com a senha fornecida ao salvá-lo. Use o método WorkBook.Load(string filename, string password) para descriptografar o arquivo com a senha fornecida ao carregar a planilha. A senha também pode ser especificada da seguinte forma:
  • Usando a propriedade WorkBook.Password (a planilha será criptografada ao salvar se essa propriedade não for nula e não será criptografada se for nula)
  • Usando o objeto SavingOptions com a propriedade SavingOptions.Password ao chamar o método WorkBook.SaveAs(string fileName, SavingOptions options)
  • Usando o objeto LoadingOptions com a propriedade LoadingOptions.Password ao chamar o método WorkBook.Load(string filename, LoadingOptions options)
• Para verificar se o objeto WorkBook será criptografado ao salvar, use a propriedade booleana WorkBook.IsEncrypted. A criptografia também pode ser desativada atribuindo WorkBook.IsEncrypted = false (Observação: a planilha não pode ser criptografada atribuindo WorkBook.IsEncrypted = true, pois isso gerará uma exceção em tempo de execução, solicitando que seja especificada uma senha).
• Definir senhas para uma pasta de trabalho de um tipo diferente de ".xlsx", ".xlsm" e ".xltx" também gerará uma exceção em tempo de execução, alertando o usuário de que a pasta de trabalho não pôde ser criptografada.
• Adiciona suporte for .NET 6.0
• Remove a dependência de System.Common.Drawing
• Remove o suporte para o .NET Framework 4.5. A versão mínima suportada do .NET Framework agora é a 4.6.2.
• Alteração significativa: o método WorkBook.SaveAs(string filename, string listDelimiter) foi renomeado para WorkBook.SaveAsWithCustomDelimiter(string filename, string listDelimiter) para remover a ambiguidade entre os métodos SaveAs(string filename, string listDelimiter) e SaveAs(string fileName, string password).
• Alteração significativa: o método IronXL.Drawing.Images.IImage.ToBitmap() foi removido, pois System.Common.Drawing não é mais suportado.
• Alteração significativa: o método IronXL.Drawing.Images.IImage.ToImage() agora retorna um objeto SixLabors.ImageSharp.Image usado como substituto para objetos System.Common.Drawing removidos.
• Corrige um erro que impedia a renderização correta da cor de fundo definida para uma célula ou intervalo em uma planilha XLSX no Excel.
• Corrige um bug em que a configuração regional do idioma tailandês gerava uma exceção de licença.
• Corrige um erro em que, cada vez que uma nova célula recebia o valor DateTime em uma planilha XLSX, um novo estilo de célula era criado para cada célula, causando estouro da tabela de estilos e corrompendo o arquivo resultante se o número de células fosse maior que 64.000.
• Melhora a velocidade de criação de grandes quantidades de células com um valor e formato DateTime. Por exemplo, criar uma pasta de trabalho com 80 mil células com o valor DateTime e formatá-las em uma única planilha costumava levar 25 segundos, e agora leva menos de 0,8 segundos (o desempenho real dependerá do ambiente em que o código for executado).

Notas de lançamento

• Adiciona uma maneira de alterar o valor de string de uma célula sem formatá-la automaticamente: isso é conseguido através da propriedade StringValue de uma célula.
• Adiciona o método AutoSizeRow a Row e WorkSheet, que altera a altura de uma linha para ajustar o conteúdo.
• Adiciona o método AutoSizeColumn a Column e WorkSheet, que altera a largura de uma linha para ajustar o conteúdo.
• Corrige um erro que causava o lançamento de uma exceção ao adicionar ou alterar uma borda.
• Corrige um erro que causava uma exceção quando o valor de uma célula era alterado para uma fórmula que dependia de uma única célula, por exemplo, "=A1".
• Corrige um erro em que uma sequência de caracteres semelhante a "12-720" era interpretada como uma data do ano 720 ao ser adicionada a uma célula. O Excel não suporta datas anteriores a 1900. Sequências de caracteres como essa não são mais interpretadas como datas. No entanto, sequências de caracteres que poderiam ser interpretadas como uma data válida após 1900 ainda serão interpretadas como uma data. Por exemplo, "12-1956". Use a propriedade StringValue para ignorar esta análise.
• Corrige um erro que ocorria quando uma planilha existente era carregada, alterada e salva: as células podiam perder a formatação original ao terem seu conteúdo modificado. Isso já não acontece.

Notas de lançamento

• Adiciona um novo IronXL.Formatting.ConditionType.
• O código antigo IronXL.Formatting.Enums.ConditionType está obsoleto.
• Adiciona suporte para estilos "Formatar como tabela".
• Corrige um erro em que arquivos contendo tabelas dinâmicas eram carregados pelo IronXL e, ao serem salvos, resultavam em arquivos corrompidos.
• Corrige um erro que ocorria quando um intervalo era copiado e colado, a planilha era salva e o arquivo resultante ficava corrompido.
• Corrige um erro em que um arquivo contendo tipos específicos de gráficos era carregado e salvo, resultando em um arquivo corrompido.
• Corrige um erro que impedia o carregamento de um arquivo contendo imagens .bmp, mas impedia o acesso a essas imagens por meio do código.
• Corrige um erro que causava a criação de uma planilha contendo um número arbitrariamente grande de células utilizadas, que, ao ser salva, resultava em um arquivo corrompido.
• Corrige alguns outros erros raros que ocasionalmente poderiam resultar em um arquivo corrompido.
• Correções em que qualquer alteração de estilo aplicada a um intervalo de células levava um tempo exorbitante. As alterações de estilo incluem mudanças de fonte (altura, negrito, etc.), alinhamento vertical, alinhamento horizontal, etc.
• Melhora a estabilidade geral dos arquivos resultantes, tanto os criados com o IronXL quanto os importados e editados pelo IronXL.
• Melhora significativamente o desempenho; gerar um arquivo com 10.000 células usadas, que antes levava 1,5 minuto, agora leva apenas 20 segundos (o tempo pode variar dependendo das operações realizadas em cada célula pelo seu código).

Notas de lançamento

• Melhoria: Suporte for .NET 6
• Melhorias: Velocidade e estabilidade

Notas de lançamento

• Melhoria: Suporte for .NET 5 e .NET 6 beta
• Melhorias: Velocidade e estabilidade
• Melhoria: Registro de logs

Notas de lançamento

• Melhoria: Suporte for .NET 5 e .NET 6 beta
• Correção de bug: a validação das chaves de licença agora é segura em relação a espaços em branco.
• Melhorias: Velocidade e estabilidade

Notas de lançamento

• Correção de bug: agora funciona com o .NET 5.07
• Correção de bug: Leitura de chaves de licença a partir de arquivos de configuração do projeto (casos extremos)
• Melhorias: Velocidade e estabilidade