Estamos felizes em anunciar o lançamento do GroupDocs.Conversion for .NET v26.9, disponível a partir de setembro de 2026. Esta versão introduz suporte a novos formatos GIS e de compressão, permite a conversão de apresentações para apresentações HTML autônomas, melhora o tratamento de TIFFs de múltiplas páginas e impõe um limite de 10 conversões em modo de avaliação por processo. Também remove membros de API obsoletos e aplica validações mais rigorosas para opções conflitantes.

O que há de novo nesta versão

  • [Recurso] Adicionar WIM como fonte de conversão para documentos de compressão (CONVERSIONNET-8488)
  • [Recurso] Adicionar Apple Archive (AAR) como fonte e destino de conversão para documentos de compressão (CONVERSIONNET-8491)
  • [Recurso] Adicionar ALZ como fonte de conversão para documentos de compressão (CONVERSIONNET-8494)
  • [Recurso] Adicionar GeoJSON Text Sequence como fonte de conversão para documentos GIS (CONVERSIONNET-8508)
  • [Recurso] Adicionar KMZ como fonte de conversão para documentos GIS (CONVERSIONNET-8510)
  • [Recurso] Adicionar suporte à conversão GIS ao framework de destino net462 (CONVERSIONNET-8511)
  • [Recurso] Adicionar GML e OSM XML como destinos de conversão para documentos GIS (CONVERSIONNET-8512)
  • [Recurso] Converter uma apresentação para uma apresentação HTML autônoma (CONVERSIONNET-8529)
  • [Melhoria] Aplicar o tamanho de página e a resolução próprios de cada quadro ao converter TIFF de múltiplas páginas para PDF (CONVERSIONNET-8519)
  • [Melhoria] Aplicar o tamanho de página e a resolução próprios do quadro ao converter um TIFF de múltiplas páginas página a página (CONVERSIONNET-8520)
  • [Melhoria] Aplicar o tamanho de página e a resolução próprios de cada quadro ao converter um TIFF de múltiplas páginas para PDF marcado (CONVERSIONNET-8521)
  • [Melhoria] Limitar o modo de avaliação a 10 conversões por processo (CONVERSIONNET-8523)
  • [Melhoria] Remover o ouvinte de conversor obsoleto, estágios de manipulador fluente e propriedades de tamanho de página (CONVERSIONNET-8561)
  • [Bug] PPTX para PDF: sublinhado duplo e tachado duplo geram coordenadas NaN no Linux (CONVERSIONNET-8388)
  • [Bug] Converter um PDF com mais de 4 páginas falha no modo de avaliação (CONVERSIONNET-8515)
  • [Bug] O limite de páginas de avaliação não é aplicado ao converter PDF para Web (CONVERSIONNET-8516)
  • [Bug] Retornar a contagem correta de páginas para um TIFF de múltiplas páginas (CONVERSIONNET-8522)

Alterações na API pública

Alterações que quebram compatibilidade

Os membros que foram marcados como obsoletos em versões anteriores foram removidos:

Removido Substituição
IConverterListener e ConverterSettings.Listener ConversionEvents OnConversionStarted / OnConversionProgress / OnConversionCompleted
ConverterSettings.OnConversionFailed ConversionEvents.OnDocumentFailed
ConverterSettings.OnConversionByPageFailed ConversionEvents.OnPageFailed
ConverterSettings.OnCompressionCompleted ConversionEvents.OnCompressionCompleted
Fluent .OnCompressionCompleted(...) after .Compress(...) (IConversionCompressResultCompleted) FluentConverter.WithEvents(e => e.OnCompressionCompleted = ...)
Interfaces fluentes IConversionHandlerSetup, IConversionHandlerFailed, IConversionHandlerCompleted IConversionHandlersStage
Interfaces fluentes IConversionByPageHandlerSetup, IConversionByPageHandlerFailed, IConversionByPageHandlerCompleted IConversionByPageHandlersStage
CadConvertOptions.PageSize / PageWidth / PageHeight CadConvertOptions.SizeSettings (PageSizeOptions)
EBookConvertOptions.PageSize / PageWidth / PageHeight EBookConvertOptions.SizeSettings (PageSizeOptions)

Na API fluente, WithOptions(...) agora devolve IConversionHandlersStage (ou IConversionByPageHandlersStage para conversão página a página). Chamadas encadeadas como .WithOptions(...).OnConversionCompleted(...).OnConversionFailed(...).Convert() continuam compilando sem alterações.

O tamanho de página agora é definido apenas através de SizeSettings:

var options = new CadConvertOptions
{
    SizeSettings = new PageSizeOptions { PageWidth = 800, PageHeight = 600 }
};

Limite de conversão no modo de avaliação

Sem uma licença válida, um processo pode executar no máximo 10 conversões. Cada chamada a Converter.Convert(...) conta como uma conversão — qualquer sobrecarga, a API fluente e chamadas que falham — independentemente de quantos arquivos de saída sejam gerados. Converter.GetDocumentInfo() e Converter.IsDocumentPasswordProtected() não contam. A contagem pertence ao processo em execução; reiniciar a aplicação reinicia a contagem. Quando uma licença válida é aplicada, as conversões deixam de ser contadas ou limitadas.

A 11ª conversão lança EvaluationLimitReachedException (derivada de GroupDocsConversionException) com a mensagem:

Você está usando o GroupDocs.Conversion no modo de avaliação: o limite de 10 documentos convertidos por processo foi atingido. Obtenha uma licença temporária gratuita de 30 dias para remover todos os limites de avaliação: https://purchase.groupdocs.com/temporary-license/

Aplique uma chave License ou Metered antes da primeira conversão para remover o limite:

License license = new License();
license.SetLicense("GroupDocs.Conversion.lic");

using (Converter converter = new Converter("sample.docx"))
{
    converter.Convert("converted.pdf", new PdfConvertOptions());
}

Código que roda sem licença pode tratar o limite:

try
{
    using (Converter converter = new Converter("sample.docx"))
    {
        converter.Convert("converted.pdf", new PdfConvertOptions());
    }
}
catch (EvaluationLimitReachedException ex)
{
    Console.WriteLine(ex.Message);
}

Saída de apresentação de slides para conversão de apresentação‑para‑HTML

A nova propriedade WebConvertOptions.SlideShow (padrão false) converte uma apresentação — PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM, ODP, OTP ou FODP — para um único arquivo HTML autônomo (Html ou Htm) que é reproduzido como apresentação de slides. Conversões existentes permanecem inalteradas a menos que SlideShow seja definido como true.

using (Converter converter = new Converter("presentation.pptx"))
{
    WebConvertOptions options = new WebConvertOptions { SlideShow = true };
    converter.Convert("slideshow.html", options);
}

Com SlideShow = true, opções contraditórias lançam InvalidConvertOptionsException antes do início da conversão:

Opção Mensagem
UsePdf = true WebConvertOptions.SlideShow cannot be combined with UsePdf: converting through PDF discards the slideshow.
Format é MHT ou MHTML WebConvertOptions.SlideShow supports only Html and Htm output, not mht. (ou mhtml)
Watermark está definido WebConvertOptions.SlideShow does not support watermarks.
Zoom diferente de 100 WebConvertOptions.SlideShow does not support Zoom.

Uma apresentação de slides é um documento navegável único, portanto as sobrecargas de Convert página a página lançam System.NotSupportedException com a mensagem Saving a presentation slideshow page by page is not supported.

Novos tipos de arquivo

Tipo Novos membros
CompressionFileType Aar, Alz, Wim
GisFileType GeoJsonSeq, Kmz
Informações de documento AarDocumentInfo, AlzDocumentInfo, WimDocumentInfo — cada um expõe a ContentTree do arquivo compactado

Exemplo de conversão de um ZIP para Apple Archive:

using (Converter converter = new Converter("assets.zip"))
{
    CompressionConvertOptions options = new CompressionConvertOptions { Format = CompressionFileType.Aar };
    converter.Convert("assets.aar", options);
}

Como obter a atualização

NuGet

Atualize para o pacote mais recente GroupDocs.Conversion via NuGet: GroupDocs.Conversion 26.9.0

dotnet add package GroupDocs.Conversion --version 26.9.0

Download direto

Faça o download dos assemblies na página GroupDocs.Conversion for .NET 26.9

Recursos